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Глава 1 



Введение 



Эта глава о том, как начать работу с СіГ. Сначала мы объясним основы инструментов 
управления версиями, затем — как запустить СіІ на вашей машине и наконец как настроить 
его, чтобы можно было работать. К концу главы вы будете понимать, для чего СіІ вообще 
сделан, почему вам следует пользоваться им, и будете уметь настраивать его. 

1.1 Об управлении версиями 

Что такое управление версиями, и зачем оно вам нужно? Система управления версиями 
(СУВ) — это система, сохраняющая изменения в одном или нескольких файлах так, чтобы 
потом можно было восстановить определённые старые версии. Для примеров в этой книге мы 
будем использовать исходные коды программ, но на самом деле можно управлять версиями 
практически любых типов файлов. 

Если вы графический или веб-дизайнер и хотите хранить каждую версию изображения 
или макета — вот это вам наверняка нужно — то пользоваться системой управления версиями 
будет очень мудрым решением. Она позволяет вернуть файлы к прежнему виду, вернуть 
к прежнему состоянию весь проект, сравнить изменения с какого-то времени, увидеть, кто 
последним изменял модуль, который дал сбой, кто создал проблему, и так далее. Вообще, 
если, пользуясь СУВ, вы всё испортили или потеряли файлы, всё можно легко восстановить. 
Кроме того, издержки на всё это будут очень маленькими. 

1.1.1 Локальные системы управления версиями 

Многие люди, чтобы управлять версиями, просто копируют файлы в другой каталог (умные 
ещё пишут текущую дату в название каталога). Такой подход очень распространён, потому что 
прост, но он ещё и чаще даёт сбои. Очень легко забыть, что ты не в том каталоге, и случайно 
изменить не тот файл, либо скопировать и перезаписать файлы не туда, куда хотел. 

Чтобы решить эту проблему, программисты уже давно разработали локальные СУВ с 
простой базой данных, в которой хранятся все изменения нужных файлов (см. рисунок 1-1). 

Одной из наиболее популярных СУВ данного типа является гсв, которая до сих пор устанавливается 
на многие компьютеры. Даже в современной операционной системе Мае ОЗ X утилита гез 
устанавливается вместе с Беѵеіорег Тоок. Эта утилита основана на работе с наборами патчей 
между парами изменений (патч — файл, описывающий различие между файлами), которые 
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Рисунок 1.1: Схема локальной СУВ. 



хранятся в специальном формате на диске. Это позволяет пересоздать любой файл на любой 
момент времени, последовательно накладывая патчи. 



1.1.2 Централизованные системы управления версиями 

Следующей большой проблемой оказалась необходимость сотрудничать с разработчиками 
за другими компьютерами. Чтобы решить её, были созданы централизованные системы управления 
версиями (ЦСУВ). В таких системах, например СѴ5, ЗиЬѵегвіоп и Реггогсе, есть центральный 
сервер, на котором хранятся все отслеживаемые файлы, и ряд клиентов, которые получают 
копии файлов из него. Много лет это был стандарт управления версиями (см. рис. 1-2). 
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Рисунок 1.2: Схема централизованного управления версиями. 



Такой подход имеет множество преимуществ, особенно над локальными СУВ. К примеру, 
все знают, кто и чем занимается в проекте. У администраторов есть чёткий контроль над тем, 
кто и что может делать, и, конечно, администрировать ЦСУВ гораздо легче, чем локальные 
базы на каждом клиенте. 

Однако при таком подходе есть и несколько серьёзных недостатков. Наиболее очевидный 
— централизованный сервер является уязвимым местом всей системы. Если сервер выключается 
на час, то в течение часа разработчики не могут взаимодействовать, и никто не может сохранить 
новые версии. Если же повреждается диск с центральной базой данных и нет резервной копии, 
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вы теряете абсолютно всё — всю историю проекта, разве что за исключением нескольких 
рабочих версий, сохранившихся на рабочих машинах пользователей. Локальные системы управления 
версиями подвержены той же проблеме: если вся история проекта хранится в одном месте, вы 
рискуете потерять всё. 



1.1.3 Распределённые системы контроля версий 

В такой ситуации в игру вступают распределенные системы управления версиями (РСУВ). 
В таких системах как СіІ, Мегсигіаі, Вагааг или Багсв клиенты не просто забирают последние 
версии файлов, а полностью копируют репозиторий. Поэтому в случае, когда «умирает» сервер, 
через который шла работа, любой клиентский репозиторий может быть скопирован обратно на 
сервер, чтобы восстановить базу данных. Каждый раз, когда клиент забирает свежую версию 
файлов, создаётся полная копия всех данных (см. рисунок 1-3). 



Сотриіег А 

( * ) 



Ѵегзіоп ОаІаЬазе 



^ ѵегзіопЗ ^ 

_ I 

Г Ѵ8ГЗІОП2 1 

^ I 

^ ѴѲГ5ЮП 1 ^ 



Зегѵег Сотриіег 



Ѵегзіоп ОаКайазе 



^ ѵегзюп 3 ^ 

^ ѵегзюп 2 ^ 

^ I 

^ ѵегзюп 1 ^ 
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Сотриіег В 



Ѵегзіог ОаІаЬазе 



^ ѵегзіоп 3 ^ 
_ I 

Г ѵегзіоп 2 ^ 

I ѵегзіоп 1 I 



Рисунок 1.3: Схема распределенной системы управления версиями 



Кроме того, в большей части этих систем можно работать с несколькими удаленными 
репозиториями, таким образом, можно одновременно работать по-разному с разными группами 
людей в рамках одного проекта. Так, в одном проекте можно одновременно вести несколько 
типов рабочих процессов, что невозможно в централизованных системах. 



1.2 Краткая история Сіі 

Как и многие замечательные вещи, СіІ начинался с, в некотором роде, разрушения во имя 
созидания и жарких споров. Ядро Ілгшх — действительно очень большой открытый проект. 
Большую часть существования ядра Ілгшх (1991-2002) изменения вносились в код путем приёма 
патчей и архивирования версий. В 2002 году проект перешёл на проприетарную РСУВ Віі- 
Кеерег. 
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В 2005 году отношения между сообществом разработчиков ядра Ілгшх и компанией, разрабатывавшей 
ВйКеерег, испортились, и право бесплатного пользования продуктом было отменено. Это 
подтолкнуло разработчиков Ьігшх (и в частности Линуса Торвальдса, создателя Ілгшх) разработать 
собственную систему, основываясь на опыте, полученном за время использования ВйКеерег. 
Основные требования к новой системе были следующими: 

• Скорость 

• Простота дизайна 

• Поддержка нелинейной разработки (тысячи параллельных веток) 

• Полная распределенность 

• Возможность эффективной работы с такими большими проектами как ядро Ыгшх (как 
по скорости, так и по размеру данных) 

С момента рождения в 2005 г. Сй разрабатывали так, чтобы он был простым в использовании, 
сохранив свои первоначальные свойства. Он невероятно быстр, очень эффективен для больших 
проектов, а также обладает превосходной системой ветвления для нелинейной разработки (см. 
главу 3). 



1.3 Основы Сіі 

Так что же такое Сй в двух словах? Эту часть важно усвоить, поскольку если вы поймете, 
что такое Сй, и каковы принципы его работы, вам будет гораздо проще пользоваться им эффективно. 
Изучая Сй, постарайтесь освободиться от всего, что вы знали о других СУВ, таких как 5иЬѵег- 
5Іоп или Регюгсе. В Сй совсем не такие понятия об информации и работе с ней как в других 
системах, хотя пользовательский интерфейс очень похож. Знание этих различий защитит вас 
от путаницы при использовании Сй. 



1.3.1 Слепки вместо патчей 

Главное отличие Сй от любых других СУВ (например, ЗиЬѵегвіоп и ей подобных) — это 
то, как Сй смотрит на данные. В принципе, большинство других систем хранит информацию 
как список изменений (патчей) для файлов. Эти системы (СѴ5, ЗиЬѵегвіоп, Регіогсе, Вахааг 
и другие) относятся к хранимым данным как к набору файлов и изменений, сделанных для 
каждого из этих файлов во времени, как показано на рисунке 1-4. 



■ Сйескіпз оѵег Ііте ■ 



^ Ѵегаіоп 1 ^ Ѵстіоп г ^ ^ Ѵегііоп 3 ^ ^ ѴеЫоп 4 ^ ^ Ѵегііоп 5 ^ 

( яі< а ^ — ді | »■ ( дг | 

( те в ^ ді ^ »■ ( дг ) 

( Ше с ) — ді ) дг ) »•( дз ) 

Рисунок 1.4: Другие системы хранят данные как изменения к базовой версии для каждого файла. 
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СіІ не хранит свои данные в таком виде. Вместо этого Сіі считает хранимые данные 
набором слепков небольшой файловой системы. Каждый раз, когда вы фиксируете текущую 
версию проекта, Сй, по сути, сохраняет слепок того, как выглядят все файлы проекта на текущий 
момент. Ради эффективности, если файл не менялся, Сіі не сохраняет файл снова, а делает 
ссылку на ранее сохранённый файл. То, как Сіі подходит к хранению данных, похоже на 
рисунок 1-5. 



■ СІіескіпз оѵег ііте ■ 



^ ѴегЯоп 1 ^ Ѵ<гЯоп г ^ ^ Ѵ<гЯоп 3 ^ ^ ѴегЯоп 4 ^ ( Ѵ«гаІоп 5 ^ 



( А ) С *' ) А1 С ) А2 

^ I _..)... ...Г... ^ I ' " 7 ' " ' 

( В ) •' В В ( В1 ^ ^ и ) 

со ѳ аз с-э ѳ 

Рисунок 1.5: Сіі хранит данные как слепки состояний проекта во времени. 



Это важное отличие Сіі от практически всех других систем управления версиями. Из- 
за него Сіі вынужден пересмотреть практически все аспекты управления версиями, которые 
другие системы взяли от своих предшественниц. Сіі больше похож на небольшую файловую 
систему с невероятно мощными инструментами, работающими поверх неё, чем на просто 
СУВ. В главе 3, коснувшись работы с ветвями в Сіі, мы узнаем, какие преимущества даёт 
такое понимание данных. 



1.3.2 Почти все операции — локальные 

Для совершения большинства операций в Сіі необходимы только локальные файлы и 
ресурсы, т.е. обычно информация с других компьютеров в сети не нужна. Если вы пользовались 
централизованными системами, где практически на каждую операцию накладывается сетевая 
задержка, вы, возможно, подумаете, что боги наделили СіІ неземной силой. Поскольку вся 
история проекта хранится локально у вас на диске, большинство операций выглядят практически 
мгновенными. 

К примеру, чтобы показать историю проекта, Сіі-у не нужно скачивать её с сервера, он 
просто читает её прямо из вашего локального репозитория. Поэтому историю вы увидите 
практически мгновенно. Если вам нужно просмотреть изменения между текущей версией 
файла и версией, сделанной месяц назад, Сіі может взять файл месячной давности и вычислить 
разницу на месте, вместо того чтобы запрашивать разницу у сервера СУВ или качать с него 
старую версию файла и делать локальное сравнение. 

Кроме того, работа локально означает, что мало чего нельзя сделать без доступа к Сети или 
ѴРІЧ. Если вы в самолёте или в поезде и хотите немного поработать, можно спокойно делать 
коммиты, а затем отправить их, как только станет доступна сеть. Если вы пришли домой, а 
ѴРМ клиент не работает, всё равно можно продолжать работать. Во многих других системах 
это невозможно или же крайне неудобно. Например, используя Регіогсе, вы мало что можете 
сделать без соединения с сервером. Работая с ЗиЬѵегзіоп и СѴ5, вы можете редактировать 
файлы, но сохранить изменения в вашу базу данных нельзя (потому что она отключена от 
репозитория). Вроде ничего серьёзного, но потом вы удивитесь, насколько это меняет дело. 
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1.3.3 Сіі следит за целостностью данных 

Перед сохранением любого файла СіГ вычисляет контрольную сумму, и она становится 
индексом этого файла. Поэтому невозможно изменить содержимое файла или каталога так, 
чтобы СіГ не узнал об этом. Эта функциональность встроена в сам фундамент СіГ и является 
важной составляющей его философии. Если информация потеряется при передаче или повредится 
на диске, СіІ всегда это выявит. 

Механизм, используемый СіІ для вычисления контрольных сумм, называется 5НА-1 хеш. 
Это строка из 40 шестнадцатеричных знаков (0-9 и а-і), которая вычисляется на основе содержимого 
файла или структуры каталога, хранимого СіГ. 5НА-1 хеш выглядит примерно так: 



24Ь9сІа6552252987аа493Ь52т'8696ССІ6СІЗЬѲѲ373 




Работая с Сіі, вы будете постоянно встречать эти хеши, поскольку они широко используются. 
Фактически, в своей базе данных СіІ сохраняет всё не по именам файлов, а по хешам их 
содержимого. 

1.3.4 Чаще всего данные в Сіі только добавляются 

Практически все действия, которые вы совершаете в Сіі, только добавляют данные в базу. 
Очень сложно заставить систему удалить данные или сделать что-то неотменяемое. Можно, 
как и в любой другой СУВ, потерять данные, которые вы ещё не сохранили, но как только они 
зафиксированы, их очень сложно потерять, особенно если вы регулярно отправляете изменения 
в другой репозиторий. 

Поэтому пользоваться Сіг — удовольствие, потому что можно экспериментировать, не 
боясь серьёзно что-то поломать. Чтобы детальнее узнать, как СіГ хранит данные и как восстановить 
то, что кажется уже потерянным, читайте раздел «Под капотом» в главе 9. 

1.3.5 Три состояния 

Теперь внимание. Это самое важное, что нужно помнить про Сіі, если вы хотите, чтобы 
дальше изучение шло гладко. В СіІ файлы могут находиться в одном из трёх состояний: 
зафиксированном, изменённом и подготовленном. «Зафиксированный» значит, что файл уже 
сохранён в вашей локальной базе. К изменённым относятся файлы, которые поменялись, но 
ещё не были зафиксированы. Подготовленные файлы — это изменённые файлы, отмеченные 
для включения в следующий коммит. 

Таким образом, в проекте с использованием Сіі есть три части: каталог Сіг (Сіг аігесіогу), 
рабочий каталог (\ѵогкіп§ аігесіогу) и область подготовленных файлов (5Іа§іп§ агеа). 

Каталог СіІ — это место, где Сіі хранит метаданные и базу данных объектов вашего 
проекта. Это наиболее важная часть Сіі, и именно она копируется, когда вы клонируете репозиторий 
с другого компьютера. 

Рабочий каталог — это извлечённая из базы копия определённой версии проекта. Эти 
файлы достаются из сжатой базы данных в каталоге СіГ и помещаются на диск для того, чтобы 
вы их просматривали и редактировали. 

Область подготовленных файлов — это обычный файл, обычно хранящийся в каталоге 
Сіі, который содержит информацию о том, что должно войти в следующий коммит. Иногда 
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1_осаІ Орегаііопз 



/ ѵѵогкіпд \ I зіадіпд \ I діі сіігесіогу | 
I гіігесіогу ] I агеа I I (герозііогу) I 



спескоиі Іпе ргоіесі 



і ч 

зіаде (ІІез > 



Рисунок 1.6: Рабочий каталог, область подготовленных файлов, каталог Сіі. 

его называют индексом (іпсіех), но в последнее время становится стандартом называть его 
областью подготовленных файлов (5Іа§іп§ агеа). 

Стандартный рабочий процесс с использованием СіІ выглядит примерно так: 



1. Вы изменяете файлы в вашем рабочем каталоге. 



2. Вы подготавливаете файлы, добавляя их слепки в область подготовленных файлов. 



3. Вы делаете коммит. При этом слепки из области подготовленных файлов сохраняются в каталог біг. . 



Если рабочая версия файла совпадает с версией в каталоге Сіі, файл считается зафиксированным. 
Если файл изменён, но добавлен в область подготовленных данных, он подготовлен. Если же 
файл изменился после выгрузки из БД, но не был подготовлен, то он считается изменённым. 
В главе 2 вы узнаете больше об этих трёх состояниях и как можно либо воспользоваться этим, 
либо пропустить стадию подготовки. 



1.4 Установка Сіі 

Настало время немного ознакомиться с использованием Сіі. Первое, что вам необходимо 
сделать, — установить его. Есть несколько способов сделать это; два основных — установка 
из исходников и установка собранного пакета для вашей платформы. 

1.4.1 Установка из исходников 

Если есть возможность, то, как правило, лучше установить СіІ из исходных кодов, поскольку 
так вы получите самую свежую версию. Каждая новая версия Сіі обычно включает полезные 
улучшения пользовательского интерфейса, поэтому получение последней версии — часто лучший 
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путь, если, конечно, вас не затрудняет установка программ из исходников. К тому же, многие 
дистрибутивы Ілшх содержат очень старые пакеты. Поэтому, если только вы не на очень 
свежем дистрибутиве или используете пакеты из экспериментальной ветки, установка из исходников 
может быть самым выигрышным решением. 

Для установки СіІ вам понадобятся библиотеки, от которых Сіі зависит: сигі, 2ІіЬ, орепвві, 
ехраі и ИЬісопѵ. Например, если в вашей системе менеджер пакетов — ушті (Ресіога), или арі- 
§еі (БеЫап, ЦЪшпд), можно воспользоваться следующими командами, чтобы разрешить все 
зависимости: 

$ уит іпзііаіі сигі-сіеѵеі ехраі-сіеѵеі деПехі-сІеѵеІ \ 
орепззі-сіеѵеі гІіЬ-сіеѵеІ 

$ арі-деі: Іпз1:а11 1іЬсиг14-дпиі1з-сІеѵ 1іЬехра(:1-сІеѵ деііехі \ 
ІіЬг-сіеѵ ІіЬззІ-сІеѵ 

Установив все необходимые библиотеки, можно идти дальше и скачать последнюю версию 
с сайта Сіі: 

ИПр : //діі. - зет . сот/сіоипіоасі 
Теперь скомпилируйте и установите: 

$ Наг -2Х-Г ді1:-1.7.2.2.1:аг.д2 

$ ссі діі-1.7.2.2 

$ таке рге1"іх=/и5г/1оса1 аіі 

$ зисіо таке рге^Гіх^/изг/ІосаІ іпз(:а11 

После этого вы можете скачать Сіі с помощью самого Сіі, чтобы получить обновления: 
$ діі сіопе діі: : //діі . кегпеі . огд/риЬ/зсш/ді1:/ді(: . діі: 



1.4.2 Установка в Ілшіх 

Если вы хотите установить СіІ под Ілгшх как бинарный пакет, это можно сделать, используя 
обычный менеджер пакетов вашего дистрибутива. Если у вас Ресіога, можно воспользоваться 
ушп: 

$ уит іпзііаіі діі-соге 

Если же у вас дистрибутив, основанный на БеЫап, например, ШипШ, попробуйте арі-§еі: 
$ арі-деі: Іпз1:а11 ді(:-соге 
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1.4.3 Установка на Мае 

Есть два простых способа установить Сіі на Мае. Самый простой — использовать графический 
инсталлятор Сіі, который вы можете скачать со страницы С-оо§1е Сосіе (см. рисунок 1-7): 
М"Ь"Ьр : //сосіе . доодіе . сот/р/діі:- озх- Іпз1:а11ег 




Рисунок 1.7: Инсталлятор Сіі под 05 X. 



Другой распространенный способ установки С-іі — черезМасРоіт.5(гі1:1:р : / /ими . тасрогСз . 
огд). Если у вас установлен МасРогів, установите Сіі так: 

$ зисіо рогі: іпзіаіі дИ-соге +зѵп +сіос +ЬазН_сотр1е1:іоп +діімеЬ 

Вам не обязательно устанавливать все дополнения, но, вероятно, вам понадобится +5ѵп, 
если вы когда-нибудь захотите использовать Сіі вместе с репозиториями ЗиЬѵегвіоп (см. главу 
8). 

1.4.4 Установка в \Ѵіпсіо\ѵ8 

Установка Сіі в \Ѵіпсіо\ѵ5 очень проста. У проекта твувСіІ: процедура установки — одна из 
самых простых. Просто скачайте файл ехе инсталлятора со страницы Соо§1е Соае и запустите 
его: 

гіѣѣр: //сосіе . доодіе . сот/р/тзуздіі: 

После установки у вас будет как консольная версия (включающая 55Н-клиент, который 
пригодится позднее), так и стандартная графическая. 

1.5 Первоначальная настройка Сіі 

Теперь, когда Сіі установлен на вашей системе, вы захотите сделать пару вещей, чтобы 
настроить вашу среду Сй. Это нужно сделать только один раз — при обновлении настройки 
сохраняются. Но вы можете их поменять в любой момент, выполнив команды снова. 

В состав Сіі входит утилита діі: соітРід, которая позволяет вам просматривать и устанавливать 
параметры, контролирующие все аспекты работы и внешнего вида СіІ. Эти параметры могут 
быть сохранены в трёх местах: 
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• Файл/еІіс/діІісогтРід содержит значения, общие для всех пользователей вашей системы 
и всех их репозиториев. Если вы указываете параметр - - зузііет, запуская діі соп - 
■рід, то параметры читаются и сохраняются в этот файл. 

• Файл-/ . дИсогтгід хранитнастройкиконкретного пользователя. Этот файл используется 
при указании параметра - -дІоЬаІ. 

• Конфигурационный файл в каталоге Сіг ( . діі/соітРід) в том репозитории, где вы 
находитесь в данный момент. Эти параметры — только для данного конкретного репозитория. 
Настройки на каждом уровне подменяют настройки из предыдущего, то есть значения в 

. діі/соітРід перекрывают соответствующие значения в /еіс/діісоітРід. 

В системах семейства \Ѵіпсіо\ѵ5 Сіг ищет файл . д іг. со гтРід в каталоге $НОМЕ (С : \0оситеп1:5 
апс! 5е1:1:іпд5\$ІІ5ЕР для большинства пользователей). Кроме того Сіі ищет файл /еіс/ 
§Ксопгі§, но уже относительно корневого каталога МЗув, который находится там, куда вы 
решили установить СіГ, когда запускали инсталлятор. 

1.5.1 Имя пользователя 

Первое, что вам следует сделать после установки СИ, — указать ваше имя и адрес электронной 
почты. Это важно, потому что каждый коммит в СіГ содержит эту информацию, и она включена 
в коммиты, передаваемые вами, и не может быть далее изменена: 



$ діі соітГід --дІоЬаІ изег.пате " ЗоЬп Оое" 

$ діі соігГід --дІоЬаІ изег.етаіі ;]оНпсіое§ехатр1е.сот 



Повторюсь, что эти настройки нужно сделать один раз, если вы указываете параметр - - 
дІоЬаІ, поскольку в этом случае Сіг будет использовать эти данные для всего, что вы делаете 
в этой системе. Если вы хотите указать другое имя или электронную почту для конкретных 
проектов, можно выполнить команду без параметра - - дІоЬаІ в каталоге с нужным проектом. 

1.5.2 Выбор редактора 

Вы указали своё имя, и теперь можно выбрать текстовый редактор, который будет использоваться, 
если будет нужно набрать сообщение в Сіі. По умолчанию СіІ использует стандартный редактор 
вашей системы, обычно это Ѵі или Ѵігп. Если вы хотите использовать другой текстовый редактор, 
например, Етасв, можно сделать следующее: 



$ діі соітГід --дІоЬаІ соге . есШог етасз 



1.5.3 Утилита сравнения 

Другая полезная настройка, которая может понадобиться — встроенная сИЯ-утилита, которая 
будет использоваться для разрешения конфликтов слияния. Например, если вы хотите использовать 
ѵітаігг: 
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$ діі согтГід --дІоЬаІ тегде.г.оо1 ѵітсіітТ 



Раздел 1.6 Как получить помощь? 



Сіг умеет делать слияния при помощи каійЗ, гкаій, теіа, ххаій, етег§е, ѵітаій, §ѵітаій, 
естег§е и орепаій, но вы можете настроить и другую утилиту Подробнее об этом написано в 
главе 7. 

1.5.4 Проверка настроек 

Если вы хотите проверить используемые настройки, можете использовать команду діі 
СОітРід - - Іізг., чтобы показать все, которые Сіг найдёт: 

$ діг. соітГід --Іізі 

изег . пате=5соЫ СИасоп 

изег . етаі1=зсНасоп§дтаі1 . сот 

соіог . 5ІаЪи8=аи1:о 

соіог . ЬгапсН=аи1:о 

соіог . іп1:егас1:іѵе=аи(:о 

соіог . сИтТ=аи1:о 



Некоторые ключи (названия) настроек могут появиться несколько раз, потому что Сіг 
читает один и тот же ключ из разных файлов (например из /ег.с/діг.С0Пт"ід и ~/ . діі: - 
согтРід). В этом случае Сіг использует последнее значение для каждого ключа. 

Также вы можете проверить значение конкретного ключа, выполнив д і 1: с о п г" ід {ключ}: 

$ діг. согтГід изег. пате 
Зсоіі: Спасоп 



1.6 Как получить помощь? 

Если вам нужна помощь при использовании Сіі, есть три способа открыть страницу руководства 
по любой команде Сіі: 

$ діі пеір <команда> 
$ діі <команда> --Иеір 
$ тап ді1:-<команда> 



Например, так можно открыть руководство по команде сопй§: 
$ діі Иеір согтГід 
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Эти команды хороши тем, что ими можно пользоваться всегда, даже без подключения 
к сети. Если руководства и этой книги недостаточно и вам нужна персональная помощь, вы 
можете попытаться поискать её на каналах #ді1: и #ді1:ИиЬ сервера Ргеепойе ІКС (ігс.ггеепоае. 
Обычно там сотни людей, отлично знающих СіІ, которые могут помочь. 

1.7 Итоги 

Теперь у вас должно быть общее понимание, что такое Сіг, и чем он отличается от ЦСУВ, 
которыми вы могли пользоваться раньше. Также у вас должна быть установлена рабочая версия 
Сіі с вашими личными настройками. Настало время перейти к изучению некоторых основ СіГ. 
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Если вы хотите начать работать с СіГ, прочитав всего одну главу, то эта глава — то, что вам 
нужно. Здесь рассмотрены все базовые команды, необходимые вам для решения подавляющего 
большинства задач возникающих при работе с Сіі. После прочтения этой главы вы научитесь 
настраивать и инициализировать репозиторий, начинать и прекращать версионный контроль 
файлов, а также подготавливать и фиксировать изменения. Мы также продемонстрируем вам 
как настроить игнорирование отдельных файлов или их групп в Сіі, как быстро и просто 
отменить ошибочные изменения, как просмотреть историю вашего проекта и изменения между 
отдельными коммитами (согдтК), а также как выкладывать (ривЬ) и забирать (риіі) изменения 
в/из удаленного (гегдоіе) репозитория. 

2.1 Создание репозитория Сіі 

Для создания репозитория СіІ существуют два основных подхода. Первый подход — 
импорт в СіІ уже существующего проекта или каталога. Второй — клонирование уже существующего 
репозитория с сервера. 

2.1.1 Создание репозитория в существующем каталоге 

Если вы собираетесь начать использовать СіГ для существующего проекта, то вам необходимо 
перейти в проектный каталог и в командной строке ввести 

$ діИ іпИ 



Эта команда создает в текущем каталоге новый подкаталог с именем содержащий все 
необходимые файлы репозитория — основу репозитория Сіг. На этом этапе ваш проект еще 
не находится под версионным контролем. (В Главе 9 приведено подробное описание файлов 
содержащихся в только что созданном вами каталоге 

Если вы хотите добавить под версионный контроль существующие файлы (в отличие от 
пустого каталога), вам стоит проиндексировать эти файлы и осуществить первую фиксацию 
изменений. Осуществить это вы можете с помощью нескольких команд §ІГ асЫ указывающих 
индексируемые файлы, а затем согштГ: 
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$ діі асісі * .с 
$ діі асісі кеаоме 

$ діі соттіі: -т 'іпіііаі рго]ес1: ѵегзіоп' 

Мы разберём, что делают эти команды чуть позже. На данном этапе, у вас есть репозиторий 
СіГ с добавленными файлами и начальным коммитом. 

2.1.2 Клонирование существующего репозитория 

Если вы желаете получить копию существующего репозитория Сіі, например, проекта, в 
котором вы хотите поучаствовать, то вам нужна команда §ІГ сіопе. Если вы знакомы с другими 
системами контроля версий, такими как ЗиЪѵегеіоп, то заметите, что команда называется сіопе, 
а не спескоиг. Это важное отличие — Сіг получает копию практически всех данных, что есть 
на сервере. Каждая версия каждого файла из истории проекта забирается (риііесі) с сервера, 
когда вы выполняете діі: сіопе. Фактически, если серверный диск выйдет из строя, вы 
можете использовать любой из клонов на любом из клиентов, для того чтобы вернуть сервер 
в то состояние, в котором он находился в момент клонирования (вы можете потерять часть 
серверных правил (вегѵег-зісіе Ьоокв) и т.п., но все данные, помещённые под версионный контроль, 
будут сохранены, подробнее см. в Главе 4). 

Клонирование репозитория осуществляется командой діі: сіопе [игі]. Например, 
если вы хотите клонировать библиотеку КиЬу СіГ, известную как СгіГ, вы можете сделать это 
следующим образом: 



$ діі сіопе дИ : //дііИиЬ . сот/зсИасоп/дгіІ . діі 




Эта команда создает каталог с именем «§гіг», инициализирует в нем каталог . дІГ., скачивает 
все данные для этого репозитория и создает (сЬескь оиі) рабочую копию последней версии. 
Если вы зайдете в новый каталог дгіі, вы увидите в нем проектные файлы, пригодные для 
работы и использования. Если вы хотите клонировать репозиторий в каталог, отличный от 
дгіі:, можно это указать в следующем параметре командной строки: 

$ діі сіопе діЬ://ді4НиЬ.сот/зсНасоп/дгі(:.ді1: тудгИ 



Эта команда делает все то же самое, что и предыдущая, только результирующий каталог 
будет назван ту§гіг. 

СіГ реализует несколько транспортных протоколов, которые вы можете использовать. В 
предыдущем примере использовался протокол діі : //,вытакжеможетевстретитьИ1:1:р(5) : // 
или изег@5егѵег : /раігі . діг, использующий протокол передачи 55Н. В Главе 4 представлены 
все доступные варианты конфигурации сервера для доступа к вашему репозиторию Сіі, а 
также их достоинства и недостатки. 
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Раздел 2.2 Запись изменений в репозиторий 



2.2 Запись изменений в репозиторий 

Итак, у вас имеется настоящий репозиторий СіІ и рабочая копия файлов для некоторого 
проекта. Вам нужно делать некоторые изменения и фиксировать «снимки» состояния (впар- 
зЬоіз) этих изменений в вашем репозиторий каждый раз, когда проект достигает состояния, 
которое вам хотелось бы сохранить. 

Запомните, каждый файл в вашем рабочем каталоге может находиться в одном из двух 
состояний: под версионным контролем (отслеживаемые) и нет (неотслеживаемые). Отслеживаемые 
файлы — это те файлы, которые были в последнем слепке состояния проекта (впарвЬоі); они 
могут быть неизмененными, измененными или подготовленными к коммиту (5Іа§еа). Неотслеживаемые 
файлы — это всё остальное, любые файлы в вашем рабочем каталоге, которые не входили в 
ваш последний слепок состояния и не подготовлены к коммиту. Когда вы впервые клонируете 
репозиторий, все файлы будут отслеживаемыми и неизмененными, потому что вы только взяли 
их из хранилища (сЬескеа іЬет оиі) и ничего пока не редактировали. 

Как только вы отредактируете файлы, СіІ будет рассматривать их как измененные, т.к. вы 
изменили их с момента последнего коммита. Вы индексируете (5Іа§е) эти изменения и затем 
фиксируете все индексированные изменения, а затем цикл повторяется. Этот жизненный цикл 
изображен на Рисунке 2-1. 



2.2.1 Определение состояния файлов 

Основной инструмент, используемый для определения, какие файлы в каком состоянии 
находятся — это команда §ІІ віаШв. Если вы выполните эту команду сразу после клонирования, 
вы увидите что-то вроде этого: 

$ діі зііаііиз 

# Оп Ьгапсіі тазйег 

поІіИіпд Ьо соттИ (иогкіпд сіігесіогу сіеап) 

Это означает, что у вас чистый рабочий каталог, другими словами — в нем нет отслеживаемых 
измененных файлов. Сіі также не обнаружил неотслеживаемых файлов, в противном случае 
они бы были перечислены здесь. И наконец, команда сообщает вам на какой ветке (ЬгапсЬ) вы 



Рііе Зіаіиз Ыіесусіе 




Рисунок 2.1: Жизненный цикл состояния ваших файлов. 
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сейчас находитесь. Пока что это всегда ветка тавіег — это ветка по умолчанию; в этой главе 
это не важно. В следующей главе будет подробно рассказано про ветки и ссылки. 

Предположим, вы добавили новый файл в ваш проект, простой КЕАБМЕ файл. Если 
этого файла раньше не было, и вы выполните діі. 5І:а1:и5, вы увидите неотслеживаемый 
файл как-то так: 

$ ѵіт КЕАРМЕ 
$ діі зіаСиз 

# Оп ЬгапсИ тазСег 

# ІІпІігаскесІ ■Гііез : 

# (изе "діС асісі <Рі1е>..." Со іпсіисіе іп мЬаі мііі Ье соттИ^еа 1 ) 

# 

# ВЕДОМ Е 

поІіИіпд аа'а'еа' Іо соттіі: Ьи1: ипігаскеа' -Гііез ргезепі: (изе "діі асіа"' Іо ігаск) 

Вы можете видеть, что новый файл КЕАБМЕ неотслеживаемый, т.к. он находится в 
секции «Ііпігаскеа йіез» в выводе команды БІаШз. Неотслеживаемый файл обычно означает, 
что СіІ нашел файл, отсутствующий в предыдущем снимке состояния (коммите); СіІ не станет 
добавлять его в ваши коммиты, пока вы явно ему это не укажете. Это предохраняет вас от 
случайного добавления в репозиторий сгенерированных двоичных файлов или каких-либо 
других, которые вы и не думали добавлять. Вы хотите добавить КЕАБМЕ, так что давайте 
сделаем это. 

2.2.2 Отслеживание новых файлов 

Для того чтобы начать отслеживать (добавить под версионный контроль) новый файл, 
используется команда діі асІСІ. Чтобы начать отслеживание файла ЕЕАБМЕ, вы можете 
выполнить следующее: 

$ діі асіа КЕАОМЕ 



Если вы снова выполните команду аіаШз, то увидите, что файл КЕАБМЕ теперь отслеживаемый 
и индексированный: 



$ дИ зіа1:из 




# Оп Ьгапсп тазЬег 




# Спапдез Со Ье соттИСео 1 : 




# (изе "діС гезеі НЕАЭ <-Гі1е>.. 


. " Со ипзСаде) 


# 




# пем Гііе: КЕАОМЕ 




# 





Вы можете видеть, что файл проиндексирован по тому, что он находится в секции «СЬап§ез 
го Ье соттіиесі». Если вы выполните коммит в этот момент, то версия файла, существовавшая 
на момент выполнения вами команды §ІІ аасі, будет добавлена в историю снимков состояния. 
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Как вы помните, когда вы ранее выполнили §ІГ іпіі, вы затем выполнили §ІГ асЫ (Шев) — это 
было сделано для того, чтобы добавить файлы в вашем каталоге под версионный контроль. 
Команда §ІІ асЫ принимает параметром путь к файлу или каталогу, если это каталог, команда 
рекурсивно добавляет (индексирует) все файлы в данном каталоге. 

2.2.3 Индексация измененных файлов 

Давайте модифицируем файл, уже находящийся под версионным контролем. Если вы 
измените отслеживаемый файл ЬепсИшагкз . гЬ и после этого снова выполните команду 
Зг_аг.и5, то результат будет примерно следующим: 

$ діі зіаііиз 

# Оп ЬгапсЬ тазЬег 

# СЬапдез іо Ье соттііііесі : 

# (изе "діі: гезеі НЕАй <'Гі1е>..." іо ипзіаде) 

# 

# пем гііе: КЕАйМЕ 

# 

# СИапдесі Ьиі поі ирсіаііесі : 

# (изе "діі: асісі <-рі1е>..." Ьо ирсіа1:е ыЬаі. мііі Ье соттШес!) 

# 

# тосіі^іесі: ЬепсИтагкз . гЬ 

# 



Файл ЬепсЬтагкз.гЬ находится в секции «Спап§еа ЬиГ по! ирааіеа» — это означает, что 
отслеживаемый файл был изменен в рабочем каталоге, но пока не проиндексирован. Чтобы 
проиндексировать его, необходимо выполнить команду діі асісі (это многофункциональная 
команда, она используется для добавления под версионный контроль новых файлов, для индексации 
изменений, а также для других целей, например для указания файлов с исправленным конфликтом 
слияния). Выполним д і 1: асі сі , чтобы проиндексировать ЬепсЬтагкз.гЬ, а затем снова выполним 
діг. 5г.аг.іі5: 



$ 


ді(: асісі ЬепсИтагкз . гЬ 




$ 


діі зіаііиз 




# 


Оп ЬгапсИ тазііег 




# 


Спапдез 1о Ье соттііііесі : 




# 


(изе "дИ гезеі НЕАй <-Гі1е>.. 


. " 1:о ипз!:аде) 


# 






# 


пем -Гііе: КЕАРМЕ 




# 


тосіі^іесі: ЬепсИтагкз . гЬ 




# 







Теперь оба файла проиндексированы и войдут в следующий коммит. В этот момент вы, 
предположим, вспомнили одно небольшое изменение, которое вы хотите сделать в ЬепсЬтагкз.гЬ 
до фиксации. Вы открываете файл, вносите и сохраняете необходимые изменения и вроде бы 
готовы к коммиту. Но давайте-ка еще раз выполним діі: зіаіиз: 
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$ ѵіт ЬепсЬтагкз . гЬ 
$ діі з(:а1:из 

# Оп ЬгапсЬ тазЬег 

# СЬапдез 1:о Ье сотті(:1:есі : 

# (изе "діі гезеі НЕАй <1 = і1е>..." іо ипзЬаде) 

# 

# пем Ше: КЕАйМЕ 

# тосіі^іесі: ЬепсЬтагкз . гЬ 

# 

# СМапдесі Ьиі поі: ирсіаііесі : 

# (изе "діі. асісі <-рі1е>..." Со ирсіа1:е мЬаІ мііі Ье соттШес!) 

# 

# тоо'л.'Пеа': ЬепсЬтагкз . гЬ 

# 



Что за черт? Теперь ЬепсЬтагкз. гЪ отображается как проиндексированный и непроиндексированный 
одновременно. Как такое возможно? Такая ситуация наглядно демонстрирует, что СіГ индексирует 
файл в точности в том состоянии, в котором он находился, когда вы выполнили команду §ІГ асИ. 
Если вы выполните коммит сейчас, то файл ЬепсЬтагкк.гЬ попадет в коммит в том состоянии, 
в котором он находился, когда вы последний раз выполняли команду §ІІ ааа, а не в том, в 
котором он находится в вашем рабочем каталоге в момент выполнения §ІІ соттк. Если вы 
изменили файл после выполнения діі. асІСІ, вам придется снова выполнить діі. абб, чтобы 
проиндексировать последнюю версию файла: 



$ діі айб ЬепсЬтагкз . гЬ 




$ діі зіаііиз 




# Оп ЬгапсЬ тазЬег 




# СЬапдез Со Ье соттііСесі : 




# (изе "дИ гезеі НЕАй <-Гі1е>.. 


. " іо ипзСаде) 


# 




# пем Гііе: КЕАЭМЕ 




# тосіі^іесі : ЬепсЬтагкз . гЬ 




# 





2.2.4 Игнорирование файлов 

Зачастую, у вас имеется группа файлов, которые вы не только не хотите автоматически 
добавлять в репозиторий, но и видеть в списках неотслеживаемых. К таким файлам обычно 
относятся автоматически генерируемые файлы (различные логи, результаты сборки программ 
и т.п.). В таком случае, вы можете создать файл .§ій§поге с перечислением шаблонов соответствующих 
таким файлам. Вот пример файла .§іп§поге: 

$ саі . діГідпоге 
*. [оа] 
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Первая строка предписывает С-іІ-у игнорировать любые файлы заканчивающиеся на .о 
или .а — объектные и архивные файлы, которые могут появиться во время сборки кода. Вторая 
строка предписывает игнорировать все файлы заканчивающиеся на тильду (~), которая используется 
во многих текстовых редакторах, например Етасв, для обозначения временных файлов. Вы 
можете также включить каталоги 1о§, Ггдр или ріа; автоматически создаваемую документацию; 
и т.д. и т.п. Хорошая практика заключается в настройке файла .§іп§поге до того, как начать 
серьезно работать, это защитит вас от случайного добавления в репозиторий файлов, которых 
вы там видеть не хотите. 

К шаблонам в файле .§ігі§поге применяются следующие правила: 

• Пустые строки, а также строки, начинающиеся с #, игнорируются. 

• Можно использовать стандартные §1оЬ шаблоны. 

• Можно заканчивать шаблон символом слэша (/) для указания каталога. 

• Можно инвертировать шаблон, использовав восклицательный знак (!) в качестве первого 
символа. 

С-1оЪ шаблоны представляют собой упрощенные регулярные выражения используемые 
командными интерпретаторами. Символ * соответствует 0 или более символам; последовательность 
[ аЬс ] — любому символу из указанных в скобках (в данном примере а, Ь или с); знак вопроса 
(?) соответствует одному символу; [ 0 - 9 ] соответствует любому символу из интервала (в 
данном случае от 0 до 9). 

Вот еще один пример файла .§іп§поге: 



# комментарий - эта строка игнорируется 

*.а # не обрабатывать файлы, имя которых заканчивается на .а 

!1іЬ.а # НО отслеживать файл ІіЬ.а, несмотря на то, что мы игнорируем все .а файлы с помощью предыдущего пра 
/ТОРО # игнорировать только файл ТООО находящийся в корневом каталоге, не относится к файлам вида зиЬсІіг/ 
тсюо 

ЬіііІаѴ # игнорировать все файлы в каталоге ЬиіІоѴ 

сіос/*.(:х1: # игнорировать сіос/поіез . іхі, но не сіос/зегѵег/агсп . 1x1 



2.2.5 Просмотр индексированных и неиндексированных изменений 

Если результат работы команды діі ЗІаЪііЗ недостаточно информативен для вас — 
вам хочется знать, что конкретно поменялось, а не только какие файлы были изменены — 
вы можете использовать команду діі. сИ'Г'Г. Позже мы рассмотрим команду діі: біТТ 
подробнее; вы, скорее всего, будете использовать эту команду для получения ответов на два 
вопроса: что вы изменили, но еще не проиндексировали, и что вы проиндексировали и собираетесь 
фиксировать. Если діі ЗІаЪііЗ отвечает на эти вопросы слишком обобщенно, то діі 
показывает вам непосредственно добавленные и удаленные строки — собственно заплатку 
(раГсЬ). 

Допустим, вы снова изменили и проиндексировали файл КЕАБМЕ, а затем изменили 
файл ЬепсЬтагкз.гЬ без индексирования. Если вы выполните команду 5 1: и 5, вы опять увидите 
что-то вроде: 
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$ діі зСаСиз 

# Оп ЬгапсИ тазЬег 

# СЬапдез Со Ье соттііііесі : 

# (изе "діС гезеі НЕАй <'Гі1е>..." Со ипзСаде) 

# 

# пем Гііе: КЕАйМЕ 

# 

# СМапдесі ЬиС поС ирсіаііесі : 

# (изе "діС асісі <1"і1е>..." Со ирсІаСе мИаС мііі Ье соттіССесІ) 

# 

# тосИ'Пес! : ЬепсИтагкз . гЬ 

# 

Чтобы увидеть, что же вы изменили, но пока не проиндексировали, наберите діі 6ІТТ 
без аргументов: 

$ діс сіігг 

сііСТ --діС а/ЬепсЬтагкз . гЬ Ь/ЬепсИтагкз . гЬ 

іпаех ЗсЬ747т. .СІа65585 100644 

— а/ЬепсИтагкз . гЬ 

+++ Ь/ЬепсИтагкз . гЬ 

і§ -36,6 +36,10 §§ аеС таіп 

@соттіС . рагепСз [0] . рагепСз [0] . рагепСз [0] 
епсі 

+ гип_сосІе(х, 'соттіСз 1') сіо 

+ діС . соттіСз . зіге 

+ епсі 

+ 

гип_сосІе(х, 'соттіСз 2') сіо 

Іод = діС . соттіСз( 'тазСег ' , 15) 
Іод . зіге 



Эта команда сравнивает содержимое вашего рабочего каталога с содержимым индекса. 
Результат показывает еще не проиндексированные изменения. 

Если вы хотите посмотреть, что вы проиндексировали и что войдет в следующий коммит, 
вы можете выполнить діі сИ'Г'Г - -сасИесІ. (В Сіі версии 1.6.1 и выше, вы также можете 
использовать діі. сИ'Г'Г - - гладей, которая легче запоминается.) Эта команда сравнивает 
ваши индексированные изменения с последним коммитом: 

$ діС йіТТ --саспесі 

СІІгТ - -д±1 а/КЕАРМЕ Ь/КЕАОМЕ 

пем Сііе тосіе 100644 

іпсіех 0000000. .03902а1 

— /сіеѵ/пиіі 

+++ Ь/РЕАРМЕ2 

іі -0,0 +1,5 §і 

+дгіС 

+ Ьу Тот РгезСоп-Мегпег, Спгіз ИапзСгаСИ 
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+ Ыір : //дііЬиЬ . сот/тозошЬо/дгіі 

+ 

+6ГІІ із а КиЬу ІіЬгагу -Тог ехігасііпд іп-Гогтаііоп -ргот а біі герозііогу 



Важно отметить, что діі. сіігТ сама по себе не показывает все изменения сделанные 
с последнего коммита — только те, что еще не проиндексированы. Такое поведение может 
сбивать с толку, так как если вы проиндексируете все свои изменения, то діі сіігТ ничего 
не вернет. 

Другой пример: вы проиндексировали файл ЬепсЬтагкв.гЬ и затем изменили его, вы можете 
использовать діі. сИ'Г'Г для просмотра как индексированных изменений в этом файле, так и 
тех, что пока не проиндексированы: 

$ діі асісі ЬепсНтагкз . гЬ 

$ есЬо '# 1ез(: Ііпе 1 » ЬепсИтагкз . гЬ 

$ діі з(:а1:из 

# Оп ЬгапсИ тазСег 

# 

# СИапдез іо Ье соттііііесі : 

# 

# тосіі^іесі: ЬепсИтагкз . гЬ 

# 

# СИапдесі Ьиі поі ирсіаііесі : 

# 

# тосіі^іесі: ЬепсИтагкз . гЬ 

# 



Теперь вы можете используя діі сіігТ посмотреть непроиндексированные изменения 
$ діі сіітТ 

біТТ --діі: а/ЬепсИтагкз . гЬ Ь/ЬепсИтагкз . гЬ 
іпйех е445е28. .86Ь2г7с 100644 
— а/ЬепсИтагкз . гЬ 
+++ Ь/ЬепсИтагкз . гЬ 
і§ -127,3 +127,4 §@ епсі 
таіп( ) 



##рр бгИ: :6і1:РиЬу.сасНе_с1іеп1:.з(:а1:з 
+# Іезі Ііпе 




а также уже проиндексированные, используя діі 6ІТТ - - сасИесІ: 



$ діі сіі-Г-Г --сасНесІ 

біТТ --діі: а/ЬепсИтагкз . гЬ Ь/ЬепсИтагкз . гЬ 

іпйех ЗсЬ747т. .е445е28 100644 

— а/ЬепсИтагкз . гЬ 

+++ Ь/ЬепсИтагкз . гЬ 

§§ -36,6 +36,10 §§ беТ таіп 



21 



Глава 2 Основы СіІ 



Зсоп СЬасоп Рго Сіі 



©соттіі: . рагепГз [0] . рагепіз[Ѳ] . рагеп1:з[Ѳ] 
епсі 



+ гип_сосІе(х, 'сотті1:з 1') сіо 

+ діі . соттііз . зіге 

+ епсі 

+ 



гип_сосіе(х, 'сотті1:з 2') сіо 

Іод = діі . сотті1:з( 'тазіег ' , 15) 
Іод . зіге 



2.2.6 Фиксация изменений 

Теперь, когда ваш индекс настроен так, как вам и хотелось, вы можете зафиксировать 
ваши изменения. Запомните, всё, что до сих пор не проиндексировано — любые файлы, 
созданные или измененные вами, и для которых вы не выполнили діі: асісі после момента 
редактирования — не войдут в этот коммит. Они останутся измененными файлами на вашем 
диске. В нашем случае, когда вы в последний раз выполняли діі Зг.аг.115, вы видели что 
все проиндексировано, и вот, вы готовы к коммиту. Простейший способ зафиксировать ваши 
изменения — это набрать діі сотшіі:: 

$ діі соттіі: 



Эта команда откроет выбранный вами текстовый редактор. (Редактор устанавливается 
системной переменной $Е0ІТ0Р — обычно это ѵіт или етасв, хотя вы можете установить ваш 
любимый с помощью команды діі: соітРід --дІоЬаІ соге . есііііог как было показано 
в Главе 1). 

В редакторе будет отображен следующий текст (это пример окна Ѵіт-а): 

# Ріеазе епГег 1:Ие соттіі: теззаде -Тог уоиг сИапдез. Ипез зіаг1:іпд 

# иіІП '#' МІ11 Ье ідпогесі, апсі ап етр1:у теззаде аЬог1:з 1:Ие сотті!:. 

# Оп ЬгапсИ тазЬег 

# СМапдез 1:о Ье соттііііесі : 



# (изе "діі гезеі НЕАй <1 = і1е>..." 1:о ипзЬаде) 

# 

# пен Гііе: РЕАРМЕ 

# тосіі^іесі: ЬепсИтагкз . гЬ 



" .дІИ/СОММІТ_Е0ІТМ5С" ІѲЬ, 283С 



Вы можете видеть, что комментарий по умолчанию для коммита содержит закомментированный 
результат работы («выхлоп») команды діі Зг.аг.115 и ещё одну пустую строку сверху. Вы 
можете удалить эти комментарии и набрать ваше сообщение или же оставить их для напоминания 
того, что вы фиксируете. (Для еще более подробного напоминания, что же вы именно меняли, 
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вы можете передать аргумент -ѵвкоманду діі: сотшіі:. Это приведет к тому, что в комментарий 
будет помещена также разница/ аіЯ ваших изменений, таким образом вы сможете точно увидеть 
всё что сделано.) Когда вы выходите из редактора, СіІ создает ваш коммит с этим сообщением 
(удаляя комментарии и вывод сіій-а). 

Другой способ — вы можете набрать ваш комментарий к коммиту в командной строке 
вместе с командой соттіі: указав его после параметра -т, как в следующем примере: 

$ діі соттіі: -т "Зіогу 182: Ріх ЬепсНтагкз ■Тог зреесі" 
[тазіег] : сгеа1:есі ЛбЗйсАТ: "Ріх ЬепсНтагкз ■Тог зреесі" 

2 ■рііез сНапдесІ, 3 іпзег1:іопз( + ) , Ѳ сіе1е1:іопз( - ) 

сгеаіе тосіе 10Ѳ644 КЕАРМЕ 



Итак, вы создали свой первый коммит! Вы можете видеть, что коммит вывел вам немного 
информации о себе: на какую ветку вы выполнили коммит (тавіег), какая контрольная сумма 
5НА-1 у этого коммита (463с1с41 = ), сколько файлов было изменено, а также статистику по 
добавленным/удаленным строкам в этом коммите. 

Запомните, что коммит сохраняет снимок состояния вашего индекса. Все, что вы не 
проиндексировали, так и торчит в рабочем каталоге как измененное; вы можете сделать еще 
один коммит, чтобы добавить эти изменения в репозиторий. Каждый раз, когда вы делаете 
коммит, вы сохраняете снимок состояния вашего проекта, который позже вы можете восстановить 
или с которым можно сравнить текущее состояние. 

2.2.7 Игнорирование индексации 

Несмотря на то, что индекс может быть удивительно полезным для создания коммитов 
именно такими, как вам и хотелось, он временами несколько сложнее, чем вам нужно в процессе 
работы. Если у вас есть желание пропустить этап индексирования, Сіг предоставляет простой 
способ. Добавление параметра -а в команду діі. соштіі: заставляет Сіі автоматически 
индексировать каждый уже отслеживаемый на момент коммита файл, позволяя вам обойтись 
без діг. асісі: 

$ діі зіа1:из 

# Оп ЬгапсИ шазііег 

# 

# СМапдей Ьиі поі: ирсіаііесі : 

# 

# тосіі^іесі: ЬепсИтагкз . гЬ 

# 

$ діі соттіі: -а -т 'асісіесі пей Ьепсптагкз' 
[тазііег 83е38с7] асісіесі пей ЬепсИтагкз 
1 -Гііез сНапдесІ, 5 іпзег1:іопз( + ) , Ѳ с!е1е1:іопз( - ) 



Обратите внимание на то, что в данном случае перед коммитом вам не нужно выполнять 
діі: асІСІ для файла ЪепсЬтагкз.гЪ. 
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2.2.8 Удаление файлов 

Для того чтобы удалить файл из Ск, вам необходимо удалить его из отслеживаемых файлов 
(точнее, удалить его из вашего индекса) а затем выполнить коммит. Это позволяет сделать 
команда діі ГШ, которая также удаляет файл из вашего рабочего каталога, так что вы в 
следующий раз не увидите его как «неотслеживаемый». 

Если вы просто удалите файл из вашего рабочего каталога, он будет показан в секции 
«Спап§еа ЬиІ по! ирааіесі» («Измененные но не обновленные» — читай не проиндексированные) 
вывода команды д і 1: 3 г. а г. и 5 : 

$ гт дгИ . детзрес 
$ діі зіаііиз 

# Оп ЬгапсИ тазЬег 

# 

# СЬапдеа 1 Ьиі поі: ирсіаііесі : 

# (изе "діі: асісі/гт <-Гі1е>..." іо ирсіа1:е мИаі мііі Ье соттіііесі) 

# 

# гіеІеЬесі: дгіі: . детзрес 

# 



Затем, если вы выполните команду діі. гт, удаление файла попадёт в индекс: 

$ діі гт дгіі: . детзрес 
гт 1 дгіі . детзрес ' 
$ діі з(:а1:из 

# Оп ЬгапсН тазіег 

# 

# СМапдез Ьо Ье соттіі1:есі : 

# (изе "діі: гезеі НЕАй <-Гі1е>..." 1:о ипзСаде) 

# 

# сіеіеъесі : дгіі: . детзрес 

# 



После следующего коммита файл исчезнет и больше не будет отслеживаться. Если вы 
изменили файл и уже проиндексировали его, вы должны использовать принудительное удаление 
с помощью параметра -1 = . Это сделано для повышения безопасности, чтобы предотвратить 
ошибочное удаление данных, которые ещё не были записаны в снимок состояния и которые 
нельзя восстановить из Сіі. 

Другая полезная штука, которую вы можете захотеть сделать — это удалить файл из индекса, 
оставив его при этом в вашем рабочем каталоге. Другими словами, вы можете захотеть оставить 
файл на вашем винчестере, и убрать его из-под бдительного ока СіІ-а. Это особенно полезно, 
если вы забыли добавить что-то в ваш файл .діііідпоге и по ошибке проиндексировали, 
например, большой файл с логами, или кучу промежуточных файлов компиляции. Чтобы 
сделать это, используйте опцию - -сасИесІ: 

$ діі гт --сасИесІ геасіте.іхі 



24 



5соП СЬасоп Рго Сіі 



Раздел 2.2 Запись изменений в репозиторий 



В команду діі: гт вы можете передавать файлы, каталоги или §1оЪ-шаблоны. Это означает, 
что вы можете вытворять что-то вроде: 

$ дИ гт 1од/\* . Іод 



Обратите внимание на обратный слэш (\) перед * . Это обязательно, так как СіГ использует 
свой собственный обработчик имён файлов вдобавок к обработчику вашего командного интерпретатора. 
Эта команда удаляет все файлы, которые имеют расширение . Іод в каталоге Іод/. Или же 
вы можете сделать вот так: 

$ діі гт \*~ 



Эта команда удаляет все файлы, чьи имена заканчиваются на ~. 

2.2.9 Перемещение файлов 

В отличие от многих других систем версионного контроля, СіГ не отслеживает непосредственно 
перемещение файла. Если вы переименуете файл в Сіі, то в СіІ не сохранится никаких метаданных 
о том, что вы переименовали файл. Однако, СіІ довольно умён в плане обнаружения перемещений 
постфактум — мы рассмотрим обнаружение перемещения файлов чуть позже. 

Таким образом, наличие в СіГ команды ШѴ выглядит несколько странным. Если вам хочется 
переименовать файл в СіГ, вы можете сделать что-то вроде: 



$ діі тѵ ■рі1е_Ггот ■рі1е_1:о 




и это отлично сработает. На самом деле, если вы выполните что-то вроде этого и посмотрите 
на статус, вы увидите, что Сіі считает, что произошло переименование файла: 

$ діі тѵ КЕАОМЕ.ІХІ КЕАРМЕ 
$ діі зіа1:из 

# Оп ЬгапсИ тазіег 

# Ѵоиг ЬгапсИ із аііеасі оі 1 ' огідіп/таз1:ег ' Ьу 1 соттіі: . 

# 

# СИапдез 1:о Ье соттіі1:есі : 

# (изе "діі гезеі НЕАР <1 = і1е>..." Ьо ипзЬаде) 

# 

# гепатесі: КЕАйМЕ.СхІ: -> КЕАРМЕ 

# 



Однако, это эквивалентно выполнению следующих команд: 

$ тѵ КЕАйМЕ.ЬхІ: РЕАОМЕ 
$ діИ гт КЕАОМЕ.Ихі 
$ діі асісі КЕАОМЕ 
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Сіі неявно определяет, что было переименование, поэтому неважно, переименуете вы 
файл так или используя команду ШѴ. Единственное отличие состоит лишь в том, что ШѴ — 
это одна команда вместо трёх — это функция для удобства. Важнее другое — вы можете 
использовать любой удобный способ, чтобы переименовать файл, и затем воспользоваться асЫ/ 
ггд перед коммитом. 

2.3 Просмотр истории коммитов 

После того как вы создадите несколько коммитов, или же вы склонируете репозиторий с 
уже существующей историей коммитов, вы, вероятно, захотите оглянуться назад и узнать, что 
же происходило с этим репозиторием. Наиболее простой и в то же время мощный инструмент 
для этого — команда д і і. 1 о д . 

Данные примеры используют очень простой проект, названный 5Ітр1е§і1:, который я часто 
использую для демонстраций. Чтобы получить этот проект, выполните: 

діі сіопе ді1:://дііПиЬ.сот/5сНасоп/зітр1еді1:-ргоді1:.ді1: 



В результате выполнения діі Іод в данном проекте, вы должны получить что-то вроде 
этого: 

$ діИ Іод 

соттіі са82а6сігТ817ес66т'44342007202690а93763949 
АиЬМог: ЗсоЫ: СНасоп <зсНасоп§дее-таі1 . сот> 
Оаіе: Моп Маг 17 21:52:11 2ѲѲ8 -07ѲѲ 

сііапдесі 1:Ие ѵегзіоп питЬег 

соттіі 085ЬЬЗЬсЬ608е1е8451сі4Ь2432г'8есЬе6306е7е7 
Аи1:Мог: ЗсоЫ: СНасоп <зсНасоп§дее-таі1 . сот> 
Оаіе: 5аИ Маг 15 16:40:33 2008 -0700 

гетоѵесі иппесеззагу 1:ез1: сосіе 

соттіі а11ЬеГѲ6а31=659402-Ге7563аЬГ99асі00сіе2209е6 
АиіИог: Зсоіі СМасоп <зсИасоп§дее-таі1 . сот> 
Оаіе: 5аИ Маг 15 10:31:28 2008 -0700 

■рігзі: соттіі: 

По умолчанию, без аргументов, діі Іод выводит список коммитов созданных в данном 
репозиторий в обратном хронологическом порядке. То есть самые последние коммиты показываются 
первыми. Как вы можете видеть, эта команда отображает каждый коммит вместе с его контрольной 
суммой 5НА-1, именем и электронной почтой автора, датой создания и комментарием. 

Существует превеликое множество параметров команды діі Іод и их комбинаций, для 
того чтобы показать вам именно то, что вы ищете. Здесь мы покажем вам несколько наиболее 
часто применяемых. 
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Один из наиболее полезных параметров — это - р, который показывает дельту (разницу/ 
аіЯ), привнесенную каждым коммитом. Вы также можете использовать -2, что ограничит 
вывод до 2-х последних записей: 



$ діі Іод -р -2 




соттіі са82а6сігТ817ес66т'44342007202690а93763949 




Аіііпог: ЗсоЫ: СИасоп <зсНасоп§дее-таі1 . сот> 




Оаіе: Моп Маг 17 21:52:11 2ѲѲ8 -Ѳ7ѲѲ 




спапдесі іЬе ѵегзіоп питЬег 




сіігТ - - діт: а/Каке-ГіІе Ь/Каке-ріІе 




ІПСІех а874Ь73. .8Г94139 100644 




— а/КакетіІе 




+++ Ь/Какетііе 




і§ -5,7 +5,7 і§ гедиіге ' гаке/детраскадеГазк ' 




зрес = бет : : Зресі^ісаіііоп . пей сіо |з| 




з.ѵегзіоп = "Ѳ.І.Ѳ" 




+ з.ѵегзіоп = "Ѳ.1.1" 




з.аиГпог = "ЗсоЫ: СИасоп" 




соттіі 085ЬЬЗЬсЬ608е1е8451сІ4Ь2432г'8есЬе6306е7е7 




АиЕпог: ЗсоЫ: СМасоп <зсНасоп§дее-таі1 . сот> 




Оаіе: 5аі Маг 15 16:40:33 2ѲѲ8 -07ѲѲ 




гетоѵесі иппесеззагу Іезт: сосіе 




сіігТ - - діт: а/1іЬ/зітр1еді1: . гЬ Ь/ІіЬ/зітрІедіІ: . гЬ 




іпсіех а0а60ае. .47с6340 100644 




— а/ІіЬ/зітрІедіі . гЬ 




+++ Ь/ІіЬ/зітрІедіі . гЬ 




§§ -18,8 +18,3 §§ сіазз Зітріебіі 




епс) 




епсі 




-Іг $0 == РНЕ 




діі: = Зітріебіі . пеы 




риіз діГ.зНом 




-епсі 




\ N0 пемііпе аі. епб оТ тііе 





Этот параметр показывает туже самую информацию плюс внесённые изменения, отображаемые 
непосредственно после каждого коммита. Это очень удобно для инспекций кода или для того, 
чтобы быстро посмотреть, что происходило в результате последовательности коммитов, добавленных 
коллегой. С командой діі. Іод вы также можете использовать группы суммирующих параметров. 
Например, если вы хотите получить некоторую краткую статистику по каждому коммиту вы 
можете использовать параметр - - зіа^: 

$ діі Іод --зЬа! 

соттіі са82а6сігТ817ес66т'44342007202690а93763949 
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Аи1:пог: ЗсоЫ; Спасоп <зспасоп§дее-таі1 . сот> 
Оаіе: Моп Маг 17 21:52:11 2ѲѲ8 -07ѲѲ 



спапдеа 1 1:пе ѵегзіоп питЬег 



Какегііе | 2 +- 

1 ■рііез сНапдесІ, 1 іпзег1:іопз( + ) , 1 сіе1е1:іопз( - ) 



соттіі 085ЬЬЗЬсЬ608е1е8451сІ4Ь2432г'8есЬе63Ѳ6е7е7 
АиЬИог: Зсоіі СНасоп <зсНасоп§дее-таі1 . сот> 
Оаіе: ЗаГ. Маг 15 16:40:33 2ѲѲ8 -0700 



гетоѵеа' иппесеззагу 1:ез1: сосіе 
1іЬ/зітр1еді1: . гЬ | 5 

1 -Гііез сНапдесІ, 0 іпзег1:іопз( + ) , 5 йе1е1:іопз( - ) 

соттіі а11Ьег'06аЗг'659402т'е7563аЬг'99аа00с:е2209е6 
АиЬМог: ЗсоЫ: СИасоп <зсИасоп§дее-таі1 . сот> 
Оаіе: 5аИ Маг 15 10:31:28 2ѲѲ8 -0700 

■рігзі: соттіі: 



КЕАйМЕ | 6 ++++++ 

Какегііе | 23 

1іЬ/зітр1еді1: . гЬ | 25 
3 -Гііез сНапдесІ, 54 іпзег1:іопз( + ) , 0 с!е1е1:іопз( - ) 



Как видно из лога, параметр - - зіаі выводит под каждым коммитом список измененных 
файлов, количество измененных файлов, а также количество добавленных и удаленных строк 
в этих файлах. Он также выводит сводную информацию в конце. Другой действительно 
полезный параметр — это --рге1:1:у. Он позволяет изменить формат вывода лога. Для 
вас доступны несколько предустановленных вариантов. Параметр опеііпе выводит каждый 
коммит в одну строку, что удобно если вы просматриваете большое количество коммитов. 
В дополнение к этому, параметры зНогІ:, г"и11, и г"и11ег, практически не меняя формат 
вывода, позволяют выводить меньше или больше деталей соответственно: 



$ дхі Іод - -рге1:1:у=опе1іпе 

са82а6агТ817ес66г'44342007202690а93763949 сИапдеа ПИе ѵегзіоп питЬег 
085ЬЬЗЬсЬ608е1е8451сІ4Ь2432т'8есЬе6306е7е7 гетоѵесі иппесеззагу СезС сосіе 
а11Ьег'06аЗт'6594Ѳ2г'е7563аЫ = 99асІ00сІе2209е6 гігзС соттіі: 



Наиболее интересный параметр — это 'Гогшаі:, который позволяет вам полностью создать 
собственный формат вывода лога. Это особенно полезно, когда вы создаете отчеты для автоматического 
разбора(парсинга) — поскольку вы явно задаете формат и уверены в том, что он не будет 
изменяться при обновлениях Сіі: 



$ діИ Іод - -ргеИИу^огтаИ : "%п - %ап, %аг : %з" 
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са82абсі 


- 5сог.г. 


СМасоп, 


11 


топг.Из 


адо 


сНапдесІ г.Не ѵегзіоп 


питЬег 


085ЬЬЗЬ 


- 5С0Г.Г. 


СИасоп, 


11 


ІТЮПГ.ИЗ 


адо 


гетоѵесі иппесеззагу 


Іезі: сосіе 


аІІЬеГО 


- Зсог.1: 


СМасоп, 


11 


топг.Из 


адо 


т'л.гзг. соттіг. 





Таблица 2-1 содержит список наиболее полезных параметров формата. 

Параметр Описание выводимых данных 
~%Н~Хеш коммита 

Сокращенный хеш коммита 
~%Т~Хеш дерева 
'%і "Сокращенный хеш дерева 
~%Р'Хеши родительских коммитов 
~%р~ Сокращенные хеши родительских коммитов 
~%ап'Имя автора 
~%ае~Электронная почта автора 

~%асГДата автора (формат соответствует параметру - -сіа1:е= ) 

~%аг~Дата автора, относительная (пр. "2 мес . назад") 

~%сп~Имя коммитера 

~%се~Электронная почта коммитера 

~%со"Дата коммитера 

~%сг~Дата коммитера, относительная 

~%з" Комментарий 



Вас может заинтересовать, в чём же разница между автором и коммитером. Автор — это 
человек, изначально сделавший работу, тогда как коммитер — это человек, который последним 
применил эту работу. Так что если вы послали патч (заплатку) в проект и один из основных 
разработчиков применил этот патч, вы оба не будете забыты — вы как автор, а разработчик 
как коммитер. Мы чуть подробнее рассмотрим это различие в Главе 5. 

Параметры опеііпе и {огтаі также полезны с другим параметром команды Іод — - - 
дгарН. Этот параметр добавляет миленький А5СІІ граф, показывающий историю ветвлений 
и слияний. Один из таких можно увидеть для нашей копии репозитория проекта Сгіі: 

$ діг. Іод - -ргег.г.у=-рогта1: : "%Ь %з" --дгарИ 

* гсІЗасГЭ ідпоге еггогз т'гот 5І6СНЮ оп т.гар 

* 5еЗее11 Мегде ЬгапсИ 'тазг.ег' оТ діт. : //дііМиЬ . сош/сІиз1:іп/дгі1: 

|\ 

| * 420еас9 АсІсІесІ а тег.НосІ тог дег.г.іпд т:Ме сиггепг. ЬгапсН. 

* | 30е367с г.ітеоиг. сосіе апсі г.езг.3 

* | 5аѲ9431 асісі Итеоиг. ргог.есг.іоп г.о дгИ 

* | еПЭЗт'в зиррогг. ■Тог Иеасіз ѵіііЬ зІазИез іп г.пет 

|/ 

* сІбѲІбЬс гедиіге ііте тог хтізсііета 

* 11сІ191е Мегде ЬгапсИ ' о'ет'ипкг. ' іпг.о Іосаі 

Мы рассмотрели только самые простые параметры форматирования вывода для діі Іод 
— их гораздо больше. Таблица 2-2 содержит как уже рассмотренные нами параметры, так и 
другие полезные параметры вместе с описанием того, как они влияют на вывод команды Іод. 
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Параметр Описание 

~-р" Выводит патч (заплатку/сІітТ) внесенный каждым коммитом. 

" --5г_а(:~ Выводит статистику по файлам измененным в каждом коммите. 

" --5погг.5г_аг_ "Отображает только строку с спапдеаѴіпзегІіопз/ 

сіеіег-іопз от вывода команды ~--зг_аг_~. 

" - -пате-опіу" Выводит список измененных файлов после каждого коммита. 

" --пате- 5г_аг_и5 "Выводит список файлов вместе с информацией о добавлении/изменении/ 

удалении . 

" - -аЫэгеѵ-соттіг. " Выводит только первые несколько символов контрольной суммы 5НА-1 вместо всех 40. 

" -- ге1аііѵе-сіа1:е 'Выводит дату в относительном формате (например, "2 недели назад") вместо использования пот 

' - -дгаргГ Выводит А5СІІ граф истории ветвлений и слияний рядом с выводом лога. 

" - -ргег-Т-у" Выводит коммиты в альтернативном формате . Параметры включают опеііпе, зИогі, Тиіі, ■риііег, и т'огта 



2.3.1 Ограничение вывода команды 1о§ 

Кроме опций для форматирования вывода, §ІІ 1о§ имеет ряд полезных ограничительных 
параметров, то есть параметров, которые дают возможность отобразить часть коммитов. Вы 
уже видели один из таких параметров — параметр - 2, который отображает только два последних 
коммита. На самом деле, вы можете задать - <П>, где П это количество отображаемых коммитов. 
На практике вам вряд ли придётся часто этим пользоваться потому, что по умолчанию СіГ 
через канал (ріре) отправляет весь вывод на ра§ег, так что вы всегда будете видеть только одну 
страницу. 

А вот параметры, ограничивающие по времени, такие как - - зіпсе и - - ипііі, весьма 
полезны. Например, следующая команда выдаёт список коммитов, сделанных за последние 
две недели: 

$ діг. Іод - -зіпсе=2 .ыеекз 



Такая команда может работать с множеством форматов — вы можете указать точную дату 
(«2008-01-15») или относительную дату, такую как «2 уеаге 1 сіау 3 тіпиіев а§о». 

Вы также можете отфильтровать список коммитов по какому-либо критерию поиска. Опция 
- -аи1:Иог позволяет фильтровать по автору, опция - - дгер позволяет искать по ключевым 
словам в сообщении. (Заметим, что, если вы укажете и опцию аиіЬог, и опцию ^гер, т0 будут 
найдены все коммиты, которые удовлетворяют первому ИЛИ второму критерию. Чтобы найти 
коммиты, которые удовлетворяют первому И второму критерию, следует добавить опцию - - 
а11-таг.сгі.) 

Последняя действительно полезная опция-фильтр для діі. Іод — это путь. Указав имя 
каталога или файла, вы ограничите вывод 1о§ теми коммитами, которые вносят изменения 
в указанные файлы. Эта опция всегда указывается последней и обычно предваряется двумя 
минусами ( - - ), чтобы отделить пути от остальных опций. 

В таблице 2-3 для справки приведён список часто употребляемых опций. 

Опция Описание 

" -(п) "Показать последние п коммитов 
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Раздел 2.3 Просмотр истории коммитов 



"--зіпсе", ' --ат"г.ег'Ограничить коммиты теми, которые сделаны после указанной даты. 
~--ипг.і1", " --Ьет"оге"Ограничить коммиты теми, которые сделаны до указанной даты. 
' - -аиіПог ' Показать только те коммиты, автор которых соответствует указанной строке. 
' - -сотшіиег " Показать только те коммиты, коммитер которых соответствует указанной строке. 



Например, если вы хотите посмотреть из истории Сіі такие коммиты, которые вносят 
изменения в тестовые файлы, были сделаны Ішгіо Натапо, не являются слияниями и были 
сделаны в октябре 2008го, вы можете выполнить что-то вроде такого: 



$ діг. Іод - -ргег.г.у="%п - %з" --аиг.пог=діг.5г.ег - -зіпсе="2ѲѲ8-і0-Ѳі" \ 

- -Ье^оге="2008-11-01" --по-тегдез -- Г./ 

5610еЗЬ - Ріх т.езг.сазе ■Гаііиге мпеп ехт-епсіесі аг.г.гіЬи1:е 

ассІЗЬЭе - Еппапсе по1сІ_1оск_т'і1е_т'ог_{ирсІа1:е, аррепсі}( ) 

т"563754 - а'етопзг.гаг.е Ьгеакаде оТ йеіасЬед сНескоит. иі 

61&43Т2 - гезет. - -пагй/геасі-ігее --гезет. -и: гетоѵе ип 

БІаЭДат' - Ріх "спескоит. --т.гаск -Ь пемЬгапсп" оп беіас 

Ь0асІ11е - риіі: аііом " діт: риіі огідіп $зотег.піпд : $сиг 



Из примерно 20 ООО коммитов в истории СіІ, данная команда выбрала всего 6 коммитов, 
соответствующих заданным критериям. 

2.3.2 Использование графического интерфейса для визуализации истории 

Если у вас есть желание использовать какой-нибудь графический инструмент для визуализации 
истории коммитов, можно попробовать распространяемую вместе с СіІ программу §іік, написанную 
на Тсі/Тк. В сущно сти §іік — это наглядный вариант д і 1: 1 о д , к тому же он принимает почти 
те же фильтрующие опции, что и діі: Іод. Если набрать в командной строке §іік, находясь в 
проекте, вы увидете что-то наподобие Рис. 2-2. 



МП.» II» гѵггы , оі рут ю бе геИНоеа . Ул\ 

гесюіеѵогфП^^^І <•»< Юг а*тші* Ьмй Л*Л 00*0*1 

джт\. гьл л ІЛе мсопо пте ІИіі юл пглплЛ ѴоІІ СІмсоп 

аюаіі «1 том Іо сіеяіе геЧ Ъежіі А ЛлпсЛ ХЫп эсоИ СІіоооп 

АіИ О" жі*"Оггк, Нол* ЕоооІ 

Ма оеселвелеу (« Орем нал» Епдеі 

ЛОТОМ) ЛКОІЦ СА*Л0О* $СОІ( СІЧСОЛ 

иромев [Ім Нолл>и Ш іеСЛІ СіЮСОЯ 

• тг: г ме -. (о ясоорі 'сілііѵт расл* алй сЯелдео I ісои Слосол 

аЛеМ «М 1 оеМо солтаі оЬркІ 5соп Спосол 

Мегде ьгапсь 'н1х2' 5соіі Спосол 

лжоеО іп ьг>«і сьопо*» *М 'и«0 юте іеи -по * ЬсоІІ Сімсоя 

СюлГу поя (о деі і N11 соом от ог Яескнгсслѵп Вгусо Кегіоу 



«е«т»г)»дт*і 



як.» 
цк.ІО: 
<К1чесоп«дт»1 



і < ,■ і ■ мі кп і 



2009-01-30 17:49:40 

гооа м ■■■■■ м и и 

200$ 0879 10:55:31 
2008 08 26 10.09:45 
2008 08 23 1140:10 
2008-08-23 09:51:15 
2008 08 22 14:51:» 
2008 08 11 10:05:57 
200808 10 15:04:59 
2008 08 07 15:35:31 
2008-08-06 11:46:51 
2008 07 31 13:47:1» 
2008 07 31 12:52:25 

I 



Смш»г: |Ц Мир ^кВасаяЦ— И.сд>» ли Фі » іі » и 

I (тс с 



им* іп« ''Л" о' Пум* «о м ггм іпт ей"» к«ы< сга-Щхгав,» 

мдп#^ оп кон (лоіоп «тмирми ли» 



<1вИ « ш* 

«(г.мспюг |И Ііп«гу. :ді(.(іами< 

«Мг.йссниг дн.віп*-». )Ч Ііилі. вн. "в" \\г» 



Рисунок 2.2: Визуализация истории с помощью дкк. 



В верхней части окна располагается история коммитов вместе с подробным графом наследников. 
Просмотрщик дельт в нижней половине окна отображает изменения, сделанные выбранным 



31 



Глава 2 Основы СіІ 



Зсоп СЬасоп Рго Сіі 



коммитом. Указать коммит можно с помощью щелчка мышью. 

2.4 Отмена изменений 

На любой стадии может возникнуть необходимость что-либо отменить. Здесь мы рассмотрим 
несколько основных инструментов для отмены произведённых изменений. Будьте осторожны, 
ибо не всегда можно отменить сами отмены. Это одно из немногих мест в Сіі, где вы можете 
потерять свою работу если сделаете что-то неправильно. 

2.4.1 Изменение последнего коммита 

Одна из типичных отмен происходит тогда, когда вы делаете коммит слишком рано, забыв 
добавить какие-то файлы, или напутали с комментарием к коммиту. Если вам хотелось бы 
сделать этот коммит ещё раз, вы можете выполнить соттіі: с опцией - - атепсі: 

$ діі соттіі: --атепсі 



Эта команда берёт индекс и использует его для коммита. Если после последнего коммита 
не было никаких изменений (например, вы запустили приведённую команду сразу после предыдущего 
коммита), то состояние проекта будет абсолютно таким же и всё, что вы измените, это комментарий 
к коммиту. 

Появится всё тот же редактор для комментариев к коммитам, но уже с введённым комментарием 
к последнему коммиту. Вы можете отредактировать это сообщение так же, как обычно, и оно 
перепишет предыдущее. 

Для примера, если после совершения коммита вы осознали, что забыли проиндексировать 
изменения в файле, которые хотели добавить в этот коммит, вы можете сделать что-то подобное: 

$ діі соттіі: -т 'іпі(:іа1 соттіі: 1 
$ діі айс! -ГогдоНеп^іІе 
$ діі соттіі: --атепсі 

Все три команды вместе дают один коммит — второй коммит заменяет результат первого. 

2.4.2 Отмена индексации файла 

В следующих двух разделах мы продемонстрируем, как переделать изменения в индексе 
и в рабочем каталоге. Приятно то, что команда, используемая для определения состояния 
этих двух вещей, дополнительно напоминает о том, как отменить изменения в них. Приведём 
пример. Допустим, вы внесли изменения в два файла и хотите записать их как два отдельных 
коммита, но случайно набрали діі асІСІ * и проиндексировали оба файла. Как теперь 
отменить индексацию одного из двух файлов? Команда діі Зг.аг.115 напомнит вам об этом: 
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Раздел 2.4 Отмена изменений 



$ діг. асісі . 
$ діг. з(:а1:из 

# Оп ЬгапсЬ тазг.ег 

# СЬапдез Г.о Ье соттіг.Г.ео' : 



# (изе " діт: гезеі НЕАР <т"і1е>..." іо ипзг.аде) 

# 

# тосіітіесі: КЕАРМЕ . Г.ХГ. 

# тосіі^іесі: ЬепсЬтагкз . гЬ 

# 



Сразу после надписи «Спап§ев Го Ье соттіпесі», написано использовать діі гезеі: 
НЕАЭ <г"і1е>. . . для исключения из индекса. Так что давайте последуем совету и отменим 
индексацию файла ЬепсЬтагкз.гЬ: 

$ діг. гезег. НЕАР ЬепсЬтагкз . гЬ 
ЬепсЬтагкз . гЬ : Іосаііу тосіі^іес) 
$ діг. зіаііиз 

# Оп ЬгапсЬ тазг.ег 

# СЬапдез Ьо Ье соттіг.г.ео' : 

# (изе "діГ. гезеі НЕАй <-рі1е>..." іо ипзг.аде) 

# 

# тоаігіесі: КЕАйМЕ . Ихг. 

# 

# СЬапдеа' Ьиі пог. ирсіат:есі : 

# (изе "діг. асісі <т"і1е>..." г.о ирсіа1:е мЬаг. иііі Ье соттіг.г.есІ) 

# (изе "діг. сЬескоиг. -- <г"і1е>..." т.о. сіізсагсі сЬапдез іп могкіпд сіігесіогу) 

# 

# тосЛ'Пеа' : ЬепсЬтагкз . гЬ 

# 



Эта команда немного странновата, но она работает. Файл ЪепсЬтагкз.гЪ изменён, но снова 
не в индексе. 

2.4.3 Отмена изменений файла 

Что, если вы поняли, что не хотите оставлять изменения, внесённые в файл ЪепсЬтагкз.гЪ? 
Как быстро отменить изменения, вернуть то состояние, в котором он находился во время последнего 
коммита (или первоначального клонирования, или какого-то другого действия, после которого 
файл попал в рабочий каталог)? К счастью, діі 5І:а1:и5 говорит, как добиться и этого. В 
выводе для последнего примера, неиндексированная область выглядит следующим образом: 

# СЬапдеа 1 Ьиг. пог. ира'аг.еа': 



# (изе "діг. асісі <т"і1е>..." г.о ирсіа1:е мЬаг. иііі Ье соттіг.г.есІ) 

# (изе "діг. сЬескоиг. -- <г"і1е>..." г.о сіізсагсі сЬапдез іп ыогкіпд сІігесг.огу) 

# 

# тосЛ'Пеа' : ЬепсЬтагкз . гЬ 

# 
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Здесь довольно ясно сказано, как отменить сделанные изменения (по крайней мере новые 
версии СіІ'а, начиная с 1.6.1, делают это; если у вас версия старее, мы настоятельно рекомендуем 
обновиться, чтобы получать такие подсказки и сделать свою работу удобней). Давайте сделаем 
то, что написано: 



$ діі сііескоиі: -- ЬепсНтагкз . гЬ 




$ діі зіаііиз 




# Оп ЬгапсИ тазЬег 




# СИапдез Ьо Ье соттііііесі : 




# (изе "діі гезеі НЕАР <гі1е>.. 


. " Ъа ипзЬаде) 


# 




# тосіігіесі: РЕАРМЕ.ИхІ: 




# 





Как вы видите, изменения были отменены. Вы должны понимать, что это опасная команда: 
все сделанные вами изменения в этом файле пропали — вы просто скопировали поверх него 
другой файл. Никогда не используйте эту команду, если вы не полностью уверены, что этот 
файл вам не нужен. Если вам нужно просто сделать, чтобы он не мешался, мы рассмотрим 
прятание (зіазЬ) и ветвление в следующей главе; эти способы обычно более предпочтительны. 

Помните, что всё, что является частью коммита в С-іГ, почти всегда может быть восстановлено. 
Даже коммиты, которые находятся на ветках, которые были удалены, и коммиты переписанные 
с помощью - -атепсі могут быть восстановлены (см. Главу 9 для восстановления данных). 
Несмотря на это, всё, что никогда не попадало в коммит, вы скорее всего уже не увидете снова. 

2.5 Работа с удалёнными репозиторями 

Чтобы иметь возможность совместной работы над каким-либо С-іГ-проектом, необходимо 
знать, как управлять удалёнными репозиториями. Удалённые репозитории — это модификации 
проекта, которые хранятся в интернете или ещё где-то в сети. Их может быть несколько, 
каждый из которых, как правило, доступен для вас либо только на чтение, либо на чтение и 
запись. Совместная работа включает в себя управление удалёнными репозиториями и помещение 
(ривЬ) и получение (риіі) данных в и из них тогда, когда нужно обменяться результатами работы. 
Управление удалёнными репозиториями включает умение добавлять удалённые репозитории, 
удалять те из них, которые больше не действуют, умение управлять различными удалёнными 
ветками и определять их как отслеживаемые (Ггаскесі) или нет и прочее. Данный раздел охватывает 
все перечисленные навыки по управлению удалёнными репозиториями. 

2.5.1 Отображение удалённых репозиториев 

Чтобы просмотреть, какие удалённые серверы у вас уже настроены, следует выполнить 
команду §ІГ гетоіе. Она перечисляет список имён-сокращений для всех уже указанных удалённых 
дескрипторов. Если вы склонировали ваш репозиторий, у вас должен отобразиться, по крайней 
мере, огі§іп — это имя по умолчанию, которое С-іГ присваивает серверу, с которого вы склонировали: 

$ діі сіопе діі: : //дііИиЬ . сош/зсИасоп/1:ісді(: . діі 
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Іпіг.іаіігео' етр1:у біг. герозііогу іп /ргіѵа^еАтр/ІісдіЬ/.дИ/ 

гетоііе: Соипг.іпд оЬзес1:з: 595, сіопе. 

гетоііе: Сотргеззіпд оЬзес1:з: 100% (269/269), сіопе. 

гетоНе: ТоИаІ 595 (сІеІИа 255), геизеа 1 589 (сіеііа 253) 

Кесеіѵіпд оЬзесіз: 100% (595/595), 73.31 КіВ | 1 КіВ/з, сіопе. 

Кезоіѵіпд сіе11:аз: 100% (255/255), сіопе. 

$ ссі г.ісдіг. 

$ діі гетоіе 

огідіп 



Чтобы посмотреть, какому ІШЬ соответствует сокращённое имя в СіГ, можно указать 
команде опцию -ѵ: 

$ діі гешо1:е -ѵ 

огідіп д±1 : //дНИиЬ . сош/зсИасоп/іісдіІ: . діі 



Если у вас больше одного удалённого репозитория, команда покажет их все. Например, 
мой репозиторий СгіГ выглядит следующим образом. 

$ ссі дгіг. 

$ діг. гептане -ѵ 

Ьакксіоог діГ. : //дііМиЬ . сот/Ьакксіоог/дгі1: . діі 

сНо45 діі : //дііИиЬ . сот/сНо45/дгіг. . діг. 

сІе^Гипкі діг. : //дііНиЬ . сот/а'ег'ипкЬ/дгИ: . діі 

коке діг. : //дііІіиЬ . сот/коке/дгіі . діг. 

огідіп дИідііИиЬ . сот : тозотЬо/дгіг. . діт: 

Это означает, что мы легко можем получить изменения от любого из этих пользователей. 
Но, заметьте, что огі§іп — это единственный удалённый сервер прописанный как 55Н ссылка, 
поэтому он единственный, в который я могу помещать свои изменения (это будет рассмотрено 
в Главе 4). 

2.5.2 Добавление удалённых репозиториев 

В предыдущих разделах мы упомянули и немного продемонстрировали добавление удалённых 
репозиториев, сейчас мы рассмотрим это более детально. Чтобы добавить новый удалённый 
Сіг-репозиторий под именем-сокращением, к которому будет проще обращаться, выполните 
діі. гешоііе асісі [сокращение] [игі]: 

$ діі гетог.е 
огідіп 

$ діі гетоГ.е асісі рЬ діг. : //діІИиЬ . сот/раи1Ьоопе/іісді1: . діі 
$ діі гетог.е -ѵ 

огідіп д±1 ://дііииЬ . сот/зсНасоп/іісдіІ: . діі 
рЬ діі : //діГ.НиЬ . сот/раиІЬоопе/Іісдіг. . діг. 
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Теперь вы можете использовать в командной строке имя рЬ вместо полного ІШЬ. Например, 
если вы хотите извлечь (^еісЬ) всю информацию, которая есть в репозитории Павла, но нет в 
вашем, вы можете выполнить §іі &ісп рЬ: 

$ діь ТеісЬ рЬ 

гетоііе: СоипПпд оЬзесІіз: 58, сіопе. 

гетоііе: Сотргеззіпд оЬзес1:з: 100% (41/41), сіопе. 

гетоііе: То1:а1 44 (йеНа 24), геизесі 1 (сіеііа 0) 

ІІпраскіпд оЬзесІз: 100% (44/44), сіопе. 

Ргот діі : //дИИиЬ . сот/раиІЬоопе/іісдіІ: 

* [пем ЬгапсИ] таз1:ег -> рЬ/таз1:ег 

* [пеы ЬгапсИ] іісдіі: -> рЬ/ЬісдіІ: 



Ветка такіег Павла теперь доступна локально как рЬ/та5І:ег. Вы можете слить (тег§е) 
её в одну из своих веток или перейти на эту ветку, если хотите её проверить. 

2.5.3 РеІсЬ и Риіі 

Как вы только что узнали, для получения данных из удалённых проектов, следует выполнить: 

$ діі ■реІісН [гето1:е-пате] 

Данная команда связывается с указанным удалённым проектом и забирает все те данные 
проекта, которых у вас ещё нет. После того как вы выполнили команду, у вас должны появиться 
ссылки на все ветки из этого удалённого проекта. Теперь эти ветки в любой момент могут быть 
просмотрены или слиты. (В 3 Главе мы перейдём к более детальному рассмотрению, что такое 
ветки и как их использовать.) 

Когда вы клонируете репозиторий, команда сіопе автоматически добавляет этот удалённый 
репозиторий под именем огі§іп. Таким образом, д і 1: ТеіісЬ огідіп извлекает все наработки, 
отправленные (ризЬ) на этот сервер после того, как вы склонировали его (или получили изменения 
с помощью ^еісЬ). Важно отметить, что команда !еісЬ забирает данные в ваш локальный репозиторий, 
но не сливает их с какими-либо вашими наработками и не модифицирует то, над чем вы работаете 
в данный момент. Вам необходимо вручную слить эти данные с вашими, когда вы будете 
готовы. 

Если у вас есть ветка, настроенная на отслеживание удалённой ветки (для дополнительной 
информации смотри следующий раздел и Главу 3), то вы можете использовать команду діі 
ри 11. Она автоматически извлекает и затем сливает данные из удалённой ветки в вашу текущую 
ветку. Этот способ может для вас оказаться более простым или более удобным. К тому же по 
умолчанию команда діі сіопе автоматически настраивает вашу локальную ветку такіег на 
отслеживание удалённой ветки тавіег на сервере, с которого вы клонировали (подразумевается, 
что на удалённом сервере есть ветка тавіег). Выполнение діі риіі, как правило, извлекает 
(^еісЬ) данные с сервера, с которого вы изначально склонировали, и автоматически пытается 
слить (тег§е) их с кодом, над которым вы в данный момент работаете. 
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2.5.4 РшЬ 

Когда вы хотите поделиться своими наработками, вам необходимо отправить (ризЬ) их в 
главный репозиторий. Команда для этого действия простая: діі: ризгі [удал, сервер] 
[ветка] . Чтобы отправить вашу ветку тавіег на сервер о г ідіп (повторимся, что клонирование, 
как правило, настраивает оба этих имени автоматически), вы можете выполнить следующую 
команду для отправки наработок на сервер: 

$ діі ризп огідіп тазіег 



Эта команда срабатывает только в случае, если вы клонировали с сервера, на котором у 
вас есть права на запись, и если никто другой с тех пор не выполнял команду ривЬ. Если вы и 
кто-то ещё одновременно клонируете, затем он выполняет команду ризЬ, а затем команду ризЬ 
выполняете вы, то ваш ривЬ точно будет отклонён. Вам придётся сначала вытянуть (риіі) их 
изменения и объединить с вашими. Только после этого вам будет позволено выполнить ривЬ. 
Смотри Главу 3 для более подробного описания, как отправлять (ризЬ) данные на удалённый 
сервер. 

2.5.5 Инспекция удалённого репозитория 



Если хотите получить побольше информации об одном из удалённых репозиториев, вы 
можете использовать команду діі: гешоііе згіои [удал, сервер] . Если вы выполните 
эту команду с некоторым именем, например, огідіп, вы получите что-то подобное: 



$ діг. гетог.е зпои огідіп 




* гетоіе огідіп 




ІІКІ. : діг. : //дііпиЬ . сот/зспасоп/іісдіі: 


.діИ 


Кетоіе Ьгапсп тегдесі ыіЬп 'діі риіі' 


мііііе оп ЬгапсН тазіег 


тазіег 




ТгаскесІ гетог.е Ьгапспез 




тазіег 




Ьісдіі: 





Она выдаёт удалённого репозитория, а также информацию об отслеживаемых ветках. 
Эта команда любезно сообщает вам, что если вы, находясь на ветке тазіег, выполните діі. 
ри 11, ветка тазіег с удалённого сервера будет автоматически влита в вашу сразу после получения 
всех необходимых данных. Она также выдаёт список всех полученных ею ссылок. 

Это был пример для простой ситуации, и наверняка вы встретились с чем-то подобным. 
Однако, если вы используете С-іг более интенсивно, вы можете увидеть гораздо большее количество 
информации от діі: гетоііе згіои: 

$ діі гетог.е зИои огідіп 
* гетоіе огідіп 

ІІКІ- : діг.@ді1:НііЬ . сот: йе'Рипкг./дз.г.МиЬ . діг. 

Кетоіе ЬгапсИ тегдесі міЫі 'діі риіі' мНіІе оп Ьгапсп іззиез 



37 



Глава 2 Основы СіІ 



Зсоп СЬасоп Рго Сіі 



іззиез 

Кетоіе ЬгапсИ тегдесі 1 діі риіі' иНіІе оп ЬгапсИ тазіег 

тазіег 

Меи гето1:е ЬгапсИез (пехі: ТеІсЬ ыііі з!:оге іп гетоііез/огідіп) 
сасМіпд 

51:а1е 1:гаскіпд ЬгапсИез (изе ' діі: гетоіе ргипе') 

ІіЬиаІкег 

иа1кег2 
Тгаскесі гетоГе ЬгапсИез 

асі 

аріѵ2 

сІазІіЬоагсІ2 
іззиез 
тазіег 
розідгез 



1_оса1 ЬгапсИ ризИесІ иі1:Н 'діі: ризИ' 
тазіег : тазГег 




Данная команда показывает какая именно локальная ветка будет отправлена на удалённый 
сервер по умолчанию при выполнении діі риз И. Она также показывает, каких веток с 
удалённого сервера у вас ещё нет, какие ветки всё ещё есть у вас, но уже удалены на сервере. 
И для нескольких веток показано, какие удалённые ветки будут в них влиты при выполнении 
діі. риіі. 

2.5.6 Удаление и переименование удалённых репозиториев 

Для переименования ссылок в новых версиях С-іг можно вылолнить діі гешоіе г е - 
пате, это изменит сокращённое имя, используемое для удалённого репозитория. Например, 
если вы хотите переименовать рЬ в раиі, вы можете сделать это следующим образом: 

$ діі гептане гепате рЬ раиі 

$ діі гетоііе 

огідіп 

раиі 



Стоит упомянуть, что это также меняет для вас имена удалённых веток. То, к чему вы 
обращались как рЬ/таз1:ег, стало раи1/таз1:ег. 

Если по какой-то причине вы хотите удалить ссылку (вы сменили сервер или больше не 
используете определённое зеркало, или, возможно, контрибьютор перестал быть активным), 
вы можете использовать діі: гетоііе гт: 

$ діі гетоііе гт раиі 
$ діі гетоііе 
огідіп 
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2.6 Работа с метками 

Как и большинство СУВ, СіІ имеет возможность помечать (Іа§) определённые моменты 
в истории как важные. Как правило, этот функционал используется для отметки моментов 
выпуска версий (ѵі.0, и т.п.). В этом разделе вы узнаете, как посмотреть имеющиеся метки 
(1а§), как создать новые. А также вы узнаете, что из себя представляют разные типы меток. 

2.6.1 Просмотр меток 

Просмотр имеющихся меток в Сіс делается просто. Достаточно набрать діі 1:ад: 

$ діС Сад 
ѵО.І 

ѴІ.З 



Данная команда перечисляет метки в алфавитном порядке; порядок их появления не имеет 
значения. 

Для меток вы также можете осуществлять поиск по шаблону. Например, репозиторий СіГ 
содержит более 240 меток. Если вас интересует просмотр только выпусков 1.4.2, вы можете 
выполнить следующее: 

$ діС Сад -1 'ѵі.4.2.*' 
ѵі.4.2.1 

ѴІ.4.2.2 
ѴІ.4.2.3 
ѴІ.4.2.4 



2.6.2 Создание меток 

СіС использует два основных типа меток: легковесные и аннотированные. Легковесная 
метка — это что-то весьма похожее на ветку, которая не меняется — это просто указатель 
на определённый коммит. А вот аннотированные метки хранятся в базе данных СИ'а как 
полноценные объекты. Они имеют контрольную сумму, содержат имя поставившего метку, 
е-гдаіі и дату, имеют комментарий и могут быть подписаны и проверены с помощью СМІЛ 
Ргіѵасу Сиага (СРС). Обычно рекомендуется создавать аннотированные метки, чтобы иметь 
всю перечисленную информацию; но если вы хотите сделать временную метку или по какой- 
то причине не хотите сохранять остальную информацию, то для этого годятся и легковесные 
метки. 

2.6.3 Аннотированные метки 

Создание аннотированной метки в С-іг выполняется легко. Самый простой способ это 
указать -а при выполнении команды 1:ад: 
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$ діС Сад -а ѵі.4 -т 'ту ѵегзіоп 1.4' 

$ діС Сад 

ѵѲ.1 

ѴІ.З 

ѵі.4 



Опция -т задаёт меточное сообщение, которое будет храниться вместе с меткой. Если 
не указать сообщение для аннотированной метки, Сіг запустит редактор, чтоб вы смогли его 
ввести. 

Вы можете посмотреть данные метки вместе с коммитом, который был помечен, с помощью 
команды діі 5 И ом: 

$ діс зпои ѵі.4 
Сад ѵі.4 

Таддег: ЗсоСС СЬасоп <зсЬасоп§дее-таі1 . сот> 
Оаіе: Моп РеЬ 9 14:45:11 2ѲѲ9 -08ѲѲ 

ту ѵегзіоп 1.4 

СОттІС 15027957951Ь64ст'874с3557а0г'3547Ьа , 83ЬЗг'г'6 
Мегде: 4а447г7... а6Ь4с97... 
АиСЬог: ЗсоСС СЬасоп <зсЬасоп§дее-таі1 . сот> 
ОаСе: 5ип РеЬ 8 19:02:46 2ѲѲ9 -08ѲѲ 

Мегде ЬгапсЬ 'ехрегітепС 



Она показывает иноформацию о выставившем метку, дату отметки коммита и аннотирующее 
сообщение перед информацией о коммите. 

2.6.4 Подписанные метки 

Вы также можете подписывать свои метки с помощью СРС, конечно, если у вас есть ключ. 
Всё что нужно сделать, это использовать - 5 вместо - а: 

$ діС Сад -з ѵі.5 -т 'ту зідпесі 1.5 Сад' 
Уои пеед а раззрЬгазе Со ипіоск Спе зесгеС кеу -Тог 
изег: "ЗсоСС СЬасоп <зсЬасоп§дее-таі1 . сот>" 
1024-ЫС РЗА кеу, Ю Р721С45А, сгеаСеа 1 2009-02-09 



Если вы выполните діг. згіои на этой метке, то увидите прикреплённую к ней СРС- 
подпись: 

$ діс зЬои ѵі.5 
Сад ѵі.5 

Таддег: ЗсоСС СЬасоп <зсЬасоп§дее-таі1 . сот> 
Расе: Моп РеЬ 9 15:22:20 2009 -0800 
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ту зідпесі 1.5 Ьад 

ВЕ6ІМ Р6Р 5І6МАТІІКЕ 

Ѵегзіоп: бпиРб ѵі.4.8 (Оагміп) 

іЕѴЕАВЕСААѴРАктдигіАСдкдомзохГсИхРгБсАСеімм+гхікддодгодѵідвмдузм 

КІѲАп2^АѴІІСА:и70х62Е<:К+Мѵ2А]82/ 
=\/ігуЗ 

ЕМЭ Р6Р ЗІбМАТІІРЕ 

соттіі 15027957951Ь64ст'874с3557а0г'3547Ьа , 83ЬЗгТ6 
Мегде: 4а447г7... а6Ь4с97... 
АиСЬог: ЗсоЫ: СЬасоп <зсИасоп§дее-таі1 . сот> 
Оаіе: 5ип РеЬ 8 19:02:46 2ѲѲ9 -08ѲѲ 



Мегде ЬгапсЬ 1 ехрегітепг. 1 




Чуть позже вы узнаете, как верифицировать метки с подписью. 

2.6.5 Легковесные метки 

Легковесная метка — это ещё один способ отметки коммитов. В сущности, это контрольная 
сумма коммита, сохранённая в файл — больше никакой информации не хранится. Для создания 
легковесной метки не передавайте опций - а, - 5 и - т: 

$ діі іад ѵ1.4-1м 

$ діИ Сад 

ѵѲ.1 

ѵі.3 

ѵі.4 

ѴІ.4-ІМ 
ѴІ.5 



На этот раз при выполнении діі 5 Нои на этой метке вы не увидите дополнительной 
информации. Команда просто покажет помеченный коммит: 

$ діі зпом ѵі.4-1и 

соттіі 15Ѳ27957951Ь64с-г874с3557а0г'3547Ьа , 83ЬЗг'г'6 
Мегде: 4а447г7... а6Ь4с97... 
АиСЬог: ЗсоЫ: СИасоп <зсИасоп§дее-таі1 . сот> 
Оаіе: 5ип РеЬ 8 19:02:46 2ѲѲ9 -08ѲѲ 

Мегде ЬгапсЬ 1 ехрегітепі: 1 



2.6.6 Верификация меток 

Для верификации подписанной метки, используйте діі: 1:ад -ѵ [имя метки]. Эта 
команда использует СРС для верификации подписи. Вам нужен открытый ключ автора подписи, 
чтобы команда работала правильно: 



41 



Глава 2 Основы СіІ 



Зсоп СЬасоп Рго Сіі 



$ діі іад -ѵ ѵі.4.2.1 

оЬ]есі 883653ЬаЬсІ8ее7еа23е6а5с392ЬЬ739348ЫеЬ61 
Суре соттіі: 
Сад ѵі.4.2.1 

Саддег Липіо С Натапо <зипкіо§сох.пе1:> 1158138501 -Ѳ700 
6ІТ 1.4.2.1 

Міпог Сіхез зіпсе 1.4.2, іпсіисііпд діС-тѵ апсі діС-НССр иіііі аІСегпаСез . 
дрд: ЗідпаСиге тасіе Ыесі 5ер 13 02:08:25 2006 РОТ изіпд Р5А кеу 10 Р3119В9А 
дрд: боосі зідпаСиге ■ргот 'Чипіо С Натапо <] ипкіо@сох . пеі>" 
дрд: ака "[}ред ітаде оТ зіге 1513]" 

Ргітагу кеу гіпдегргіпі: : 3565 2А26 2040 Е066 С9А7 4А70 С0С6 09А4 Р311 9В9А 




Если у вас нет открытого ключа автора подписи, вы вместо этого получите что-то подобное: 



дрд: ЗідпаСиге тасіе Иеа 1 5ер 13 02:08:25 2006 РОТ изіпд Р5А кеу 10 Р3119В9А 
дрд: Сап'! сИеск зідпаСиге: риЫіс кеу поС -Гоітс) 
еггог: соиіс) поі ѵегі^у 1:Ме Сад 'ѵі.4.2.1' 




2.6.7 Выставление меток позже 



Также возможно помечать уже пройденные коммиты. Предположим, что история коммитов 
выглядит следующим образом: 



$ діС Іод - -ргеССу=опе1іпе 






15027957951Ь64сг'874с3557а0г'3547Ьс183ЬЗт'г'6 


Мегде Ь 


^апсіі 'ехрегітепС 


а6Ь4с97498Ьа , 301СІ84096СІа251с98а07с7723е65 


Ьедіппіпд игіСе зиррогС 


0О'52аааЬ4479697а , а7686СІ5т'77аЗа , 64сІ9165190 


опе тоге ІИіпд 


6й52а271еа , а8725415634а , а , 79а , ааЬЬс4а , 9Ь6008е 


Мегде Ь 


'апсіі 'ехрегітепС 


ѲЬ7434сІ86859сс7Ь8сЗсІ5е1а , а , СІг'есІ66г'г'742т'сЬс 


асісіесі а 


соттіС СипсСіоп 


4682с3261057305ЬсІСІ616е23Ь64Ь0857сі832627Ь 


асісіесі а 


Сосіо С"і1е 


166ае0с4с13т'420721асЬЫ15сс33848сІг'сс2121а 


зСагСесІ 


игііе зиррогС 


9гсеЬ02сІ0ае598е95а , с970Ь74767г'19372а , 61ат8 


ирсІаСесІ 


гакеС"і1е 


964Г16сІ36аТсса , е844893сас5Ь347е7ЬЗсІ44аЫэс 


соттіС СЬе 1:осІо 


8а5сЬс430-Г1а9сЗсІ00Гаае-Г-ГсІ07798508422908а 


ирсІаСесІ 


геаоіте 



Теперь предположим, что вы забыли отметить версию проекта ѵі.2, которая была там, где 
находится коммит «ирааіесі гакеШе». Вы можете добавить метку апосля. Для отметки коммита 
укажите контрольную сумму коммита (или часть её) в конце команды: 

$ діС Сад -а ѵі.2 9гсеЬ02 



Можете проверить, что коммит теперь отмечен: 
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$ діі Сад 

ѵѲ.1 

ѵі.2 

ѴІ.З 

ѵі.4 

ѴІ.4-ІМ 
ѴІ.5 

$ діі зііои ѵі.2 
Сад ѵі.2 

Таддег: ЗсоСг. СНасоп <зсНасоп§дее-таі1 . сот> 
Оаіе: Моп РеЬ 9 15:32:16 2ѲѲ9 -08ѲѲ 

ѵегзіоп 1.2 

соттіі ЭтсеЬѳгсШаебЭВеЭбсІсЭУѲЬУДУбУГІЭЗУгсІбІаГВ 
АиСМог: Мадпиз СИасоп <шсИасоп§дее-таі1 . сот> 
Оаіе: 5ип Арг 27 20:43:35 2ѲѲ8 -Ѳ7ѲѲ 

ирсІаСесІ гакег"і1е 



2.6.8 Обмен метками 

По умолчанию, команда діг. ри 5 п не отправляет метки на удалённые серверы. Необходимо 
явно отправить (ривЬ) метки на общий сервер после того, как вы их создали. Это делается так 
же, как и выкладывание в совместное пользование удалённых веток — нужно выполнить діг. 
ризп огідіп [имя метки]. 

$ діі ризН огідіп ѵі.5 

СоипСіпд оЬзесСз: 50, сіопе. 

Сотргеззіпд оЬ}'ес1:з: 100% (38/38), сіопе. 

ЫгіСіпд оЬзесИз: 100% (44/44), 4.56 КіВ, сіопе. 

Тоіаі 44 (гіеІИа 18), геизесі 8 (сіеііа 1) 

То діі§ді1:ИиЬ . сот : зсііасоп/зітріедіі . діі. 

* [пеы Г.ад] ѵі.5 -> ѵі.5 

Если у вас есть много меток, которые хотелось бы отправить все за один раз, можно 
использовать опцию - - г. ад 5 для команды діг. ризп. В таком случае все ваши метки отправятся 
на удалённый сервер (если только их уже там нет). 

$ діі ризИ огідіп --іадз 

Соипіііпд о^ест-в: 50, сіопе. 

Сотргеззіпд оЬ}ес1:з: 100% (38/38), сіопе. 

ИгіИіпд оЬзесіз: 100% (44/44), 4.56 КіВ, сіопе. 

Тоіаі 44 (йеІИа 18), геизесі 8 (сІеІСа 1) 

То діі§ді1:ИиЬ . сот : зсПасоп/зітрІедіг. . діг. 

* [пем Г.ад] ѵ0.1 -> ѵ0.1 

* [пем Г.ад] ѵі.2 -> ѵі.2 
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* [пем 1:ад] 


VI. 


,4 -> 


VI 


,4 


* [пей 1:ад] 


VI. 


.4-ІѴІ 


-> 


ѴІ.4-ІМ 


* [пеы Гад] 


VI 


.5 -> 


VI 


,5 



Теперь, если кто-то склонирует (сіопе) или выполнит діі. риіі из вашего репозитория, 
то он получит вдобавок к остальному и ваши метки. 

2.7 Полезные советы 

Перед тем как закончить данную главу об основах СіІ, дадим несколько полезных советов 
о том, как сделать ваш опыт работы с СіГ проще, удобнее или привычнее. Многие люди 
используют СіГ, не прибегая к этим советам, и мы дальше в книге не будем ссылаться на них 
или подразумевать, что вы ими пользуетесь, но вам всё же стоит знать о них. 

2.7.1 Автоматическое дополнение 

Если вы используете командую оболочку ВазЬ, СіГ поставляется с замечательным сценарием 
(ксгірг), который вы можете активировать. Скачайте исходный код С-іГ и посмотрите в каталоге 
соп1:гіЬ/сотр1е1:іоп; там должен быть файл ді1:-сотр1е1:іоп . Ьазгі. Скопируйте этот 
файл в ваш домашний каталог и добавьте следующее в свой файл . ЬазНгс: 

зоигсе -/ . ді1:-сотр1е(:іоп . ЬазИ 



Если вы хотите настроить автоматическое дополнение в ВавЬ для всех пользователей, 
скопируйте этот сценарий в каталог /ор1:/1оса1/е1:с/Ьа5гі_сотр1е1:іоп . сі на Мае системах 
или в каталог /е1:с/Ьа5гі_сотр1е1:іоп . сі/ на Ьіпих системах. Это каталог, из которого 
ВавЬ автоматически загружает сценарии для автодополнения. 

Если вы используете СіІ ВазЬ на \Ѵіпсіо\ѵ5, что является стандартным при установке СіІ 
на \Ѵіпао\ѵ5 с помощью твувСіІ:, то автодополнение должно быть настроено заранее. 

Нажав ТаЬ во время ввода команды СіГ, вы должны получить набор вариантов на выбор: 

$ діі со<ИаЬ><1:аЬ> 
соттіі соггГід 



В данном случае, набрав §ІГ со и дважды нажав клавишу ТаЬ, вы получите как варианты 
соттк и сопй§. Добавление т<1:аЬ> выполнит дополнение до діі соштіі: автоматически. 

То же самое работает и для опций, что, возможно, полезней. Например, если вы хотите 
выполнить команду діі Іод и не помните какую-то опцию, вы можете начать её печатать и 
затем нажать ТаЬ, чтобы увидеть, что подходит: 

$ діі Іод --5<1:аЬ> 

--зНоіЧз^аІ: --зіпсе= - -згс-рге1 ; іх= --зіаі: --зишшагу 
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Это довольно приятная уловка, и она может спасти вам немного времени от работы и 
чтения документации. 

2.7.2 Псевдонимы в Сіі 

СіІ не будет пытаться сделать вывод о том, какую команду вы хотели ввести, если вы 
ввели её не полностью. Если вы не хотите печатать каждую команду СіІ полностью, вы легко 
можете настроить псевдонимы (аііав) для каждой команды с помощью д і 1: соітГід. Вот пара 
примеров того, что вы, возможно, захотите настроить: 



$ діг. согтГід 


--дІоЬаІ аііаз, 


, со 


сЬескоиГ. 


$ діг. согтГід 


--дІоЬаІ аііаз, 


,Ьг 


ЬгапсИ 


$ діг. согтГід 


--дІоЬаІ аііаз, 


сі 


соттіі: 


$ діг. согтГід 


--дІоЬаІ аііаз, 


зг. 


зіаіиз 



Это означает, что, например, вместо набирания діі сотшіі:, вам достаточно набрать 
только діі сі. По мере освоения Ск вам, вероятно, придётся часто пользоваться и другими 
командами. В этом случае без колебаний создавайте новые псевдонимы. 

Такой способ может также быть полезен для создания команд, которые, вы думаете, должны 
существовать. Например, чтобы исправить неудобство, с которым вы столкнулись при исключении 
файла из индекса (ип51а§е), вы можете добавить собственный псевдоним в Сіі: 

$ діг. согтГід --дІоЬаІ аііаз . ипзііаде ' гезег. НЕАЭ --' 



Это делает следующие две команды эквивалентными: 

$ діг. ипзг.аде т"і1еА 
$ діг. гезеГ. НЕАР -ГіІеА 



Так как будто немного понятней. Также обычно добавляют команду Іазі: следующим 
образом: 



$ діг. согтРід --дІоЬаІ аііаз.іазі 'Іод -1 НЕАР' 




Так легко можно просмотреть последний коммит: 



$ діг. ІазИ 

соттіі ббЭЗвсіаеЗЗгЭсУаеЬебЭВсггДбаВебаГЭѲсІѲДбДб 
Аиг.Ног: ОозИ боеЬеІ <сІгеатегЗ§ехатр1е . сот> 
Оаіе: Тие Аид 26 19:48:51 2ѲѲ8 +08ѲѲ 

г.езі -Тог сиггепі ІіеасІ 
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Можно сказать, что СіГ просто заменяет эти новые команды на то, для чего вы создавали 
псевдоним (аііаз). Однако, возможно, вы захотите выполнять внешнюю команду, а не подкоманду 
Сіі. В этом случае, следует начать команду с символа ! . Такое полезно, если вы пишите свои 
утилиты для работы с СіГ-репозиторием. Продемонстрируем этот случай на примере создания 
псевдонима діі ѵізиаі для запуска діі: к: 



$ діі согтГід --дІоЬаІ аііаз . ѵізиаі " ! дііік" 



2.8 Итоги 

К этому моменту вы умеете выполнять все базовые локальные операции с Сіі: создавать 
или клонировать репозиторий, вносить изменения, индексировать и фиксировать эти изменения, 
а также просматривать историю всех изменений в репозиторий. Дальше мы рассмотрим самую 
убийственную особенность Сіг'а — его модель ветвления. 
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Почти каждая СУВ имеет в какой-то форме поддержку ветвления. Ветвление означает, 
что вы отклоняетесь от основной линии разработки и продолжаете работу, не вмешиваясь в 
основную линию. Во многих СУВ это в некотором роде дорогостоящий процесс, зачастую 
требующий от вас создания новой копии каталога с исходным кодом, что может занять продолжительное 
время для больших проектов. 

Некоторые говорят, что модель ветвления в С-іг это его "кіііег !еашге" и она безусловно 
выделяет С-іг в СУВ-сообществе. Что же в ней такого особенного? Способ ветвления в Сіг 
чрезвычайно легковесен, что делает операции ветвления практически мгновенными и переключение 
туда-сюда между ветками обычно так же быстрым. В отличие от многих других СУВ, Сіі 
поощряет процесс работы, при котором ветвление и слияние осуществляется часто, даже по 
несколько раз в день. Понимание и владение этой функциональностью даёт вам уникальный 
мощный инструмент и может буквально изменить то, как вы ведёте разработку. 

3.1 Что такое ветка? 

Чтобы на самом деле разобраться в том, как СіГ работает с ветками, мы должны сделать 
шаг назад и рассмотреть, как СіІ хранит свои данные. Как вы, наверное, помните из Главы 1, 
СіІ хранит данные не как последовательность изменений или дельт, а как последовательность 
снимков состояния (впарвпоі:). 

Когда вы фиксируете изменения в СіІ, СіІ сохраняет фиксируемый объект, который содержит 
указатель на снимок содержимого индекса, метаданные автора и комментария и ноль или больше 
указателей на коммиты, которые были прямыми предками этого коммита: ноль предков для 
первого коммита, один — для обычного коммита и несколько — для коммита, полученного в 
результате слияния двух или более веток. 

Для наглядности давайте предположим, что у вас есть каталог, содержащий три файла, 
и вы их все индексируете и делаете коммит. При подготовке файлов для каждого из них 
вычисляется контрольная сумма (5НА-1 хеш мы упоминали в Главе 1), затем эти версии файлов 
сохраняются в СіГ-репозиторий (СіГ обращается к ним как к двоичным данным), а их контрольные 
суммы добавляются в индекс: 

$ діи асИ КЕАОМЕ Сезі.гЬ ІЛСЕМ5Е 

$ діі соттіі: -т 'іпіііаі соттИ оТ ту ргозесі 1 
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Когда вы создаёте коммит, выполняя діі. сотшіі:, Сіі вычисляет контрольную сумму 
каждого подкаталога (в нашем случае только корневого каталога) и сохраняет объекты для 
этого дерева в Сіі-репозиторий. Затем Сіі создаёт объект для коммита, который имеет метаданные 
и указатель на корень проектного дерева. Таким образом, Сіі может воссоздать текущее состояние, 
когда нужно. 

Ваш Сіі-репозиторий теперь содержит пять объектов: по одному массиву двоичных данных 
для содержимого каждого из трёх файлов, одно дерево, которое перечисляет содержимое каталога 
и определяет соответствие имён файлов и массивов двоичных данных, и один коммит с указателем 
на корень этого дерева и все метаданные коммита. Схематично данные в вашем Сіі-репозитории 
выглядят, как показано на Рисунке 3-1. 
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Рисунок 3.1: Данные репозитория с единственным коммитом. 



Если вы сделаете некоторые изменения и зафиксируете их, следующий коммит сохранит 
указатель на коммит, который шёл непосредственно перед ним. После еще двух коммитов ваша 
история может выглядеть, как показано на Рисунке 3-2. 
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Рисунок 3.2: Данные объектов Сіі в случае нескольких коммитов. 



Ветка в Сіі — это просто легковесный подвижный указатель на один из этих коммитов. 
Имя ветки по умолчанию в Сіі — тазііег. Когда вы вначале создаёте коммиты, вам даётся 
ветка шазііег, указывающая на последний сделанный коммит. При каждом новом коммите 
указатель сдвигается вперёд автоматически. 

Что происходит, когда вы создаёте новую ветку? Итак, этим вы создаёте новый указатель, 
который вы можете перемещать. Скажем, вы создаёте новую ветку под названием Іе5ііп§. Это 
делается командой д і 1: ЬгапсИ: 
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Рисунок 3.3: Ветка указывает на историю коммитов. 



$ діг. ЬгапсИ Ьез^іпд 

Эта команда создает новый указатель на тот самый коммит, на котором вы сейчас находитесь 
(см. Рисунок 3-4). 



тавіег 
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Рисунок 3.4: Несколько веток, указывающих на историю коммитов. 

Откуда Сіі узнает, на какой ветке вы находитесь в данный момент? Он хранит специальный 
указатель, который называется НЕАБ (верхушка). Учтите, что это сильно отличается от концепции 
НЕАБ в других СУВ, таких как ЗиЬѵегвіоп или СѴ5, к которым вы, возможно, привыкли. В 
Сіі это указатель на локальную ветку, на которой вы находитесь. В данном случае вы всё ещё 
на ветке тазііег. Команда діі: ЬгапсИ только создала новую ветку, она не переключила вас 
на неё (см. Рисунок 3-5). 
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Рисунок 3.5: Файл НЕАО указывает на текущую ветку. 

Чтобы перейти на существующую ветку, вам надо выполнить команду діі: сНескоиІ:. 
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Давайте перейдем на новую ветку іе5ііп§: 



$ діі сПескоиІ: Ііезііпд 



Это действие перемещает НЕАБ так, чтобы тот указывал на ветку №5Йп§ (см. Рисунок 



3-6). 



98са9 




34ас2 





іЗОаЬ 








Рисунок 3.6: НЕАО указывает на другую ветку, когда вы их переключаете. 
В чём важность этого действия? Давайте сделаем ещё один коммит: 



$ ѵіт Ііезі: . гЬ 

$ діі соттіі: -а -т 'тасіе а сНапде' 



На Рисунке 3-7 показан результат. 



98са9 
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ІЗОаЬ 




с2Ь9в 









Рисунок 3.7: Ветка, на которую указывает НЕАО, движется вперёд с каждым коммитом. 

Это интересно, потому что теперь ваша ветка ЬезІІпд передвинулась вперёд, но ваша 
ветка таз г всё ещё указывает на коммит, на котором вы были, когда выполняли діі: с И ее к - 
оиі:, чтобы переключить ветки. Давайте перейдём обратно на ветку тазііег: 



$ діі сЬескоиІ: тазіег 
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98са9 



34ас2 



ПОаЬ 



с2Ь9е 



Рисунок 3.8: НЕАО перемещается на другую ветку при сЬескоиѴе. 



На Рисунке 3-8 можно увидеть результат. 

Эта команда выполнила два действия. Она передвинула указатель НЕАБ назад на ветку 
тазіег и вернула файлы в вашем рабочем каталоге назад, в соответствие со снимком состояния, 
на который указывает тавіег. Это также означает, что изменения, которые вы делаете, начиная 
с этого момента, будут ответвляться от старой версии проекта. Это полностью откатывает 
изменения, которые вы временно делали на ветке 1е5Йп§. Таким образом, дальше вы можете 
двигаться в другом направлении. 

Давайте снова сделаем немного изменений и зафиксируем их: 



$ ѵіт іезг. . гЬ 

$ діг. соттіг. -а -т 'тасіе о^Ьег сЬапдез' 



Теперь история вашего проекта разветвилась (см. Рисунок 3-9). Вы создали новую ветку, 
перешли на неё, поработали на ней немного, переключились обратно на основную ветку и 
выполнили другую работу. Оба эти изменения изолированы на отдельных ветках: вы можете 
переключаться туда и обратно между ветками и слить их, когда будете готовы. И вы сделали 
всё это простыми командами ЬгапсН и сНескоиІ:. 



НЕАО 



т 

тазіег 



87аЬ2 



98са9 




34ас2 




ПОаЬ 


-4 


4 



с2Ь9е 



іезчпд 



Рисунок 3.9: История с разошедшимися ветками. 

Из-за того, что ветка в Сіі на самом деле является простым файлом, который содержит 40 
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символов контрольной суммы 5НА-1 коммита, на который он указывает, создание и удаление 
веток практически беззатратно. Создание новой ветки настолько же быстро и просто, как 
запись 41 байта в файл (40 символов + символ перехода на новую строку). 

Это разительно отличается от того, как в большинстве СУВ делается ветвление. Там это 
приводит к копированию всех файлов проекта в другой каталог. Это может занять несколько 
секунд или даже минут, в зависимости от размера проекта, тогда как в С-іГ этот процесс всегда 
моментален. Также благодаря тому, что мы запоминаем предков для каждого коммита, поиск 
нужной базовой версии для слияния уже автоматически выполнен за нас, и в общем случае 
слияние делается легко. Эти особенности помогают поощрять разработчиков к частому созданию 
и использованию веток. 

Давайте поймём, почему вам стоит так делать. 

3.2 Основы ветвления и слияния 

Давайте рассмотрим простой пример ветвления и слияния с таким процессом работы, 
который вы могли бы использовать в настоящей разработке. Вы будете делать следующее: 

1. Работать над веб-сайтом. 



3. Выполните некоторую работу на этой ветке. 

На этом этапе вы получите звонок о том, что сейчас критична другая проблема, и её надо 
срочно решить. Вы сделаете следующее: 

1. Вернётесь на производственную ветку. 

2. Создадите ветку для исправления ошибки. 

3. После тестирования ветки с исправлением сольёте её обратно и отправите в продакшн. 



3.2.1 Основы ветвления 

Для начала представим, что вы работаете над своим проектом и уже имеете пару коммитов 
(см. Рисунок 3-10). 

Вы решили, что вы будете работать над проблемой №53 из системы отслеживания ошибок, 
используемой вашей компанией. Разумеется, С-іг не привязан к какой-то определенной системе 
отслеживания ошибок. Просто из-за того, что проблема №53 является основной задачей, над 
которой вы хотите работать, вы создадите новую ветку для работы в ней. Чтобы создать ветку 
и сразу же перейти на неё, вы можете выполнить команду діі сНескоиІ: с ключом - Ь: 



52 



Зсоіі СЬасоп Рго Сіі 



Раздел 3.2 Основы ветвления и слияния 



таяег 

Рисунок 3.10: Короткая и простая история коммитов. 



$ діі спескоиг. -Ь ізз53 
5иіг.спесІ 1:о а пем ЬгапсИ "іззБЗ" 



Это сокращение для: 



$ діг. Ьгапсіі ізз53 
$ діі сПескоиг. ізз53 



Рисунок 3-11 показывает результат. 



таііег 




I '"" I 

Рисунок 3.11: Создание новой ветки /указателя. 

Во время работы над вашим веб-сайтом вы делаете несколько коммитов. Эти действия 
сдвигают ветку І5553 вперёд, потому что вы на неё перешли (то есть ваш НЕАБ указывает 
на неё; см. Рисунок 3-12): 

$ ѵіт іпсіех . М.т1 

$ діі соттіг. -а -т 'аа'о'еа' а пей ■роог.ег [іззие 53]' 




15553 



Рисунок 3.12: Ветка ізв53 передвинулась вперёд во время работы. 

Теперь вы получаете звонок о том, что есть проблема с веб-сайтом, которую необходимо 
немедленно устранить. С Сіі вам нет нужды создавать заплатку вместе с теми изменениями, 
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которые вы уже сделали для І5553. А также не надо прикладывать много усилий, чтобы 
отменить эти изменения перед тем, как вы сможете начать работать над решением срочной 
проблемы. Всё, что вам нужно сделать, это перейти на ветку шазіег. 

Однако, прежде чем сделать это, учтите, что если в вашем рабочем каталоге или индексе 
имеются незафиксированные изменения, которые конфликтуют с веткой, на которую вы переходите, 
С-іі не позволит переключить ветки. Лучше всего при переключении веток иметь чистое рабочее 
состояние. Существует несколько способов добиться этого (а именно, прятанье (віазЬ) работы 
и правка (атепсі) коммита), которые мы рассмотрим позже. А на данный момент представим, 
что вы зафиксировали все изменения и можете переключиться обратно на ветку тазіег: 

$ діі сііескоиі: тазііег 
5иі1:сИесІ Ьо ЬгапсИ "тазГег" 

Теперь рабочий каталог проекта находится точно в таком же состоянии, что и в момент 
начала работы над проблемой №53, так что вы можете сконцентрироваться на срочном изменении. 
Очень важно запомнить: Сіі возвращает ваш рабочий каталог к снимку состояния того коммита, 
на который указывает ветка, на которую вы переходите. Он добавляет, удаляет и изменяет 
файлы автоматически, чтобы гарантировать, что состояние вашей рабочей копии идентично 
последнему коммиту на ветке. 

Итак, вам надо срочно исправить ошибку. Давайте создадим для этого ветку, на которой 
вы будете работать (см. Рисунок 3-13): 

$ діі сМескои!: -Ь 'поіі^іх' 
5мі1:сііес1 <:о а пей ЬгапсИ "Иоі^іх" 
$ ѵіт іпсіех . М.т1 

$ діі соттіі: -а -т '■ріхесі іЬе Ьгокеп етаіі асісігезз 1 
[Иоіі^іх] : сгеа1:есі За0874с: "г"іхесі (:Ие Ьгокеп етаіі асісігезз" 
1 ■рііез спапдесі, 0 іпзег1:іопз( + ) , 1 сіе1е1:іоп5( - ) 




і»53 



Рисунок 3.13: Ветка для решения срочной проблемы базируется на ветке тазіег. 

Вы можете запустить тесты, убедиться, что решение работает, и слить (тег§е) изменения 
назад в ветку тавіег, чтобы включить его в продукт. Это делается с помощью команды діі 
тегде: 
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$ діі сМескоиг. тазіег 
$ діі тегде Но1:т"іх 
Іірсіаііпд -Г42С576. .За0874с 
Разі т'огмагс! 
КЕАйМЕ | 1 - 

1 ■рііез сііапдесі, 0 іпзег1:іопз( + ) , 1 с1е1ег.л_оп5( - ) 



Наверное, вы заметили фразу «Раві гогѵѵага» в этом слиянии. Так как ветка, которую мы 
слили, указывала на коммит, являющийся прямым родителем коммита, на котором мы сейчас 
находимся, Сіі просто сдвинул её указатель вперёд. Иными словами, когда вы пытаетесь слить 
один коммит с другим таким, которого можно достигнуть, проследовав по истории первого 
коммита, СіІ поступает проще, перемещая указатель вперёд, так как нет расходящихся изменений, 
которые нужно было бы сливать воедино. Это называется «(аві {огѵгагсі» (перемотка). 

Ваши изменения теперь в снимке состояния коммита, на который указывает ветка тазіег, 
и вы можете включить изменения в продукт (см. Рисунок 3-14). 



таяег 




І5553 



Рисунок 3.14: После слияния ветка тазіег указывает туда же, куда и ветка Нофх. 

После того, как очень важная проблема решена, вы готовы вернуться обратно к работе, 
которую делали, прежде чем были прерваны. Однако, сначала удалите ветку НоЁ'Пх, так как 
она больше не нужна — ветка тазііег уже указывает на то же место. Вы можете удалить 
ветку с помощью опции -с! к діі: ЬгапсИ: 

$ діі ЬгапсН -сі Моі^Ріх 

ОеІеГесі ЬгапсН НоИ^іх (ЗаѲ874с). 



Теперь вы можете вернуться обратно к рабочей ветке для проблемы №53 и продолжить 
работать над ней (см. Рисунок 3-15): 



$ діг. сНескоиг. ізз53 




Зміісііесі г.0 ЬгапсИ "ізз53" 




$ ѵіт іпсіех . М.т1 




$ діг. соттіг. -а -т ' ■ріпізіпесі ІЬе пем ■роог.ег [іззие 


53] ' 


[іззБЗ] : сгеаг.есІ асІ82сІ7а: "'ГіпізЬей г.Не пем 1"ооІ;ег 


[іззие 53]" 


1 ■Гііез спапдесі, 1 іпзег1:іопз( + ) , Ѳ сіе1е1:іоп5( - ) 
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Рисунок 3.15: Ветка І5853 может двигаться вперёд независимо. 

Стоит напомнить, что работа, сделанная на ветке Иоіі^ІХ, не включена в файлы на ветке 
І5 553. Если вам это необходимо, вы можете выполнить слияние ветки тазііег в ветку І5 5 53 
посредством команды діі: шегде тазііег. Или же вы можете подождать с интеграцией 
изменений до тех пор, пока не решите включить изменения на І5553 в продуктовую ветку 
шазііег. 

3.2.2 Основы слияния 

Представьте себе, что вы разобрались с проблемой №53 и готовы объединить эту ветку и 
свой тазііег. Чтобы сделать это, вы выполните слияние вашей ветки І5553 в ветку шазііег 
точно так же, как делали ранее с веткой Иоіі^ІХ. Всё, что вы должны сделать — перейти на 
ту ветку, в которую вы хотите внести свои изменения и выполнить команду діі: шегде: 

$ діі сііескоиі: таз(:ег 
$ діі тегде ізз53 
Мегде тасіе Ьу гесигзіѵе. 
КЕАРМЕ I 1 + 

1 ■рііез сНапдесІ, 1 іпзег1:іопз( + ) , Ѳ сіе1е1:іоп5( - ) 

Сейчас слияние выглядит немного не так, как для ветки НоС'Пх, которое вы делали ранее. 
В данном случае ваша история разработки разделилась в некоторой точке. Так как коммит 
на той ветке, на которой вы находитесь, не является прямым предком для ветки, которую 
вы сливаете, Сіі-у придётся проделать кое-какую работу. В этом случае Сіі делает простое 
трехходовое слияние, используя при этом два снимка состояния репозитория, на которые указывают 
вершины веток, и общий снимок-прародитель для этих двух веток. На рисунке 3-16 выделены 
три снимка, которые СіІ будет использовать для слияния в этом случае. 

Вместо того, чтобы просто передвинуть указатель ветки вперёд, СіІ создаёт новый снимок 
состояния, который является результатом трехходового слияния, и автоматически создает новый 
коммит, который указывает на этот новый снимок состояния (смотри Рисунок 3-17). Такой 
коммит называют коммит-слияние, так как он является особенным из-за того, что имеет больше 
одного предка. 

Стоит отметить, что Сіі определяет наилучшего общего предка для слияния веток; в СѴ5 
или ЗиЪѵегеіоп (версии ранее 1.5) этого не происходит. Разработчик должен сам указать основу 
для слияния. Это делает слияние в СіІ гораздо более простым занятием, чем в других системах. 

Теперь, когда вы осуществили слияние ваших наработок, ветка І5553 вам больше не 
нужна. Можете удалить ее и затем вручную закрыть карточку (йскеі) в вашей системе: 
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(ЗпарзМоІ (о Л 
Мегде Іп ) 

Рисунок 3.16: Сіі автоматически определяет наилучшего общего предка для слияния веток. 



талег 




іи53 



Рисунок 3.17: Сіі автоматически создает новый коммит, содержащий результаты слияния. 



$ діг. ЬгапсН -сі ізз53 



3.2.3 Основы конфликтов при слиянии 

Иногда процесс слияния не идет гладко. Если вы изменили одну и ту же часть файла 
по-разному в двух ветках, которые собираетесь объединить, СіІ не сможет сделать это чисто. 
Если ваше решение проблемы №53 изменяет ту же часть файла, что и Ноіі^іх, вы получите 
конфликт слияния, и выглядеть он будет примерно следующим образом: 

$ діі тегде іззБЗ 
Аиг-О-тегдіпд іпсіех . И(:т1 

СОМРІ-ІСТ (сопіепі): Мегде соітРІісг. іп іпсіех . М.т1 

Аиііотаііс тегде ■Гаііесі; ■Гіх соггГ1іс1:з апсі ІЬеп соттіі: іЬе гезиіг.. 

СіІ не создал новый коммит для слияния. Он приостановил этот процесс до тех пор, пока 
вы не разрешите конфликт. Если вы хотите посмотреть, какие файлы не прошли слияние (на 
любом этапе после возникновения конфликта), можете выполнить команду діі. 5І:а1:и5: 
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[таз1:ег*]$ дИ зіаіиз 
іпсіех . Иіті : пеесіз тегде 

# Оп ЬгапсИ тазЬег 

# СЬапдей Ьиі поХ. ирсІат:есІ : 

# (изе "діі асісі <т"і1е>..." Ьо ирсіа1:е ыЬаі. иііі Ье сотті1:1:есІ) 

# (изе " діт: сНескоиі -- <т"і1е>..." Ьо сіізсагсі сНапдез іп могкіпд сіігесіогу) 

# 

# иптегдеа 1 : іпсіех.пііті 

# 

Всё, что имеет отношение к конфликту слияния и что не было разрешено, отмечено как 
шітег§еа\ СіІ добавляет стандартные маркеры к файлам, которые имеют конфликт, так что вы 
можете открыть их вручную и разрешить эти конфликты. Ваш файл содержит секцию, которая 
выглядит примерно так: 

«««< НЕАОііпсІех.МітІ 

<сііѵ ісІ="-Гоо1:ег">соп(:ас1: : етаіі . зиррог1:§ді1:НиЬ . сот</сІіѵ> 



<сііѵ ісІ="-Гоо1:ег"> 

ріеазе сопііасі: из а1: зиррог1:§ді(:ІіиЬ . сот 
</сііѵ> 

»»>» Ізз53:іпсіех.іі1:т1 



В верхней части блока (всё что выше =======) это версия из НЕАБ (вашей ветки тазіег, 

так как именно на неё вы перешли перед выполнением команды тег§е), всё, что находится в 
нижней части — версия в І5 553. Чтобы разрешить конфликт, вы должны либо выбрать одну 
из этих частей, либо как-то объединить содержимое по своему усмотрению. Например, вы 
можете разрешить этот конфликт заменой всего блока, показанного выше, следующим блоком: 

<сііѵ ісІ="-Гоо1:ег"> 

ріеазе соп1:ас1: из аі ешаіі . зиррогі§ді1:ИиЬ . сот 
</сііѵ> 



Это решение содержит понемногу из каждой части, и я полностью удалил строки <«««, 
======= и »»»>. После того, как вы разрешили каждую из таких секций с каждым из 

конфликтных файлов, выполните діі асІСІ для каждого конфликтного файла. Индексирование 
будет означать для СіГ, что все конфликты в файле теперь разрешены. Если вы хотите использовать 
графические инструменты для разрешения конфликтов, можете выполнить команду діі. шегде- 
1:оо1, которая запустит соответствующий графический инструмент и покажет конфликтные 
ситуации: 

$ діі тегдеііооі 

тегде іооі сапсіісіаіез : кбіТТЗ {ксИ'Г'Г ххбіТТ теісі дѵітсІітТ орепсіітТ етегде ѵітсІітТ 
Мегдіпд іЬе т"і1ез: іпсІех.И1:т1 
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ІМогтаІ тегде соігГІісі ■Тог 


' іпсіех . Иіті ' : 


{Іосаі} : тосІі-ГіесІ 




{гетоіе}: тосІі-ГіесІ 




Ніі геГ.игп Г.о зіагі тегде 


гезоіиііоп Г.оо1 (орепсІі-гТ) : 



Если вы хотите использовать другой инструмент для слияния, нежели выбираемый по 
умолчанию (СіІ выбрал орепсИ'Г'Г для меня, так как я выполнил команду на Мае). Вы можете 
увидеть все поддерживаемые инструменты, указанные выше после «тег§е Іооі сапсііааіеа». 
Укажите название предпочтительного для вас инструмента. В Главе 7 мы обсудим, как изменить 
это значение по умолчанию для вашего окружения. 

После того, как вы выйдете из инструмента для выполнения слияния, Ск спросит вас, 
было ли оно успешным. Если вы отвечаете, что да — файл индексируется (добавляется в 
область для коммита), чтобы дать вам понять, что конфликт разрешен. 

Можете выполнить діі 5І:а1:и5 ещё раз, чтобы убедиться, что все конфликты были 
разрешены: 

$ діі зіа1:из 

# Оп ЬгапсН шазіег 

# СМапдез Ьо Ье соттііііесі : 

# (изе "діГ. гезеі НЕАй <1 = і1е>..." 1:о ипз1:аде) 

# 

# тосіі^іесі: іпсіех.ііііті 

# 



Если вы довольны тем, что получили, и удостоверились, что всё, имевшее конфликты, 
было проиндексировано, можете выполнить діі сотшіі: для завершения слияния. По умолчанию 
сообщение коммита будет выглядеть примерно так: 

Мегде ЬгапсИ 'ізз53' 

СогтГІісіз : 
іпсіех.ііііті 

# 

# II: Іоокз Ііке уои тау Ье соттііііпд а МЕК6Е. 

# 11" ІМіз із поі соггесг., ріеазе гетоѵе 1:Ие ■Гііе 

# .діі/МЕК6Е_НЕАР 

# апсі ігу адаіп. 

# 



Вы можете дополнить это сообщение информацией о том, как вы разрешили конфликт, 
если считаете, что это может быть полезно для других в будущем. Например, можете указать 
почему вы сделали то, что сделали, если это не очевидно, конечно. 
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3.3 Управление ветками 

Теперь, когда вы уже попробовали создавать, объединять и удалять ветки, пора познакомиться 
с некоторыми инструментами для управления ветками. Когда вы начнете постоянно использовать 
ветки, эти инструменты очень вам пригодятся. 

Команда діі ЬгапсН делает несколько больше, чем просто создает и удаляет ветки. 
Если вы выполните ее без аргументов, то получите простой список ваших текущих веток: 

$ діі Ьгапсіі 

І5353 

* тазіег 
Іезііпд 



Обратите внимание на символ * , стоящий перед веткой таз 1; е г : он указывает на ту ветку, 
на которой вы находитесь в настоящий момент. Это означает, что если вы сейчас выполните 
коммит, ветка таз 1: е г переместится вперёд в соответствии с вашими последними изменениями. 
Чтобы посмотреть последний коммит на каждой из веток, выполните команду діі ЬгапсН 
-ѵ: 

$ діі ЬгапсН -ѵ 

ізз53 93Ь412с -ріх заѵазсгірі: іззие 
* тазіег 7а988Ѳ5 Мегде ЬгапсИ 'ізз53' 

Іезііпд 782г"сІ34 асісі зсоЫ: іо іііе аиііііог Іізі: іп ІИе геасітез 



Другая полезная возможность для выяснения состояния ваших веток состоит в том, чтобы 
оставить в этом списке только те ветки, для которых вы выполнили (или не выполнили) слияние 
с веткой, на которой сейчас находитесь. Для этих целей в СіГ, начиная с версии 1.5.6, есть 
опции - -тегдесі и - -по-тегдесі. Чтобы посмотреть те ветки, которые вы уже слили с 
текущей, можете выполнить команду діі: ЬгапсИ --тегдесі: 

$ діі ЬгапсИ --тегдесі 

І3353 
* тазіег 



Так как вы уже выполняли слияние для ветки І5553 ранее, вы видите ее в своем списке. 
Неплохой идеей было бы удалить командой діі ЬгапсН - сі те ветки из этого списка, перед 
которыми нет символа *; вы уже объединили наработки из этих веток с другой веткой, так что 
вы ничего не теряете. 

Чтобы посмотреть все ветки, содержащие наработки, которые вы еще не объединили с 
текущей веткой, выполните команду діі ЬгапсИ - -по-тегдесі: 

$ діі ЬгапсИ --по-тегдесі 
ІезЬіпд 
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Вы увидите оставшуюся ветку. Так как она содержит ещё не слитые наработки, попытка 
удалить ее командой діі. ЬгапсИ - сі не увенчается успехом: 



$ діі Ьгапсіі -6 іез(:іпд 










еггог: Ѵпе ЬгапсИ 'г.ез1:іпд' 


із поі 


ап 


апсезііог оТ уоиг 


сиггепі НЕАО. 


ІТ уои аге зиге уои иапг. іо 


сіеіеіе 




гип 'діг. ЬгапсИ 


-0 іез(:іпд ' . 



Если вы действительно хотите удалить ветку и потерять наработки, вы можете сделать это 
при помощи опции - И, как указано в подсказке. 

3.4 Приемы работы с ветками 

Теперь, когда вы познакомились с основами ветвления и слияния, что вам делать с ветками 
дальше? В этом разделе мы рассмотрим некоторые стандартные приёмы работы, которые 
становятся возможными, благодаря лёгкому осуществлению ветвления. И вы сможете выбрать, 
включить ли вам какие-то из них в свой цикл разработки. 

3.4.1 Долгоживущие ветки 

Так как СіІ использует простое трехходовое слияние, периодически сливать одну ветку 
с другой на протяжении большого промежутка времени достаточно просто. Это значит, вы 
можете иметь несколько веток, которые всегда открыты и которые вы используете для разных 
стадий вашего цикла разработки; вы можете регулярно сливать одну из них с другой. 

Многие разработчики С-іІ'а придерживаются такого подхода, при котором ветка тазіег 
содержит исключительно стабильный код — единственный выпускаемый код. Для разработки 
и тестирования используется параллельная ветка, называемая аеѵеіор или пехі, она может не 
быть стабильной постоянно, но в стабильные моменты её можно слить в тавіег. Эта ветка 
используется для объединения завершённых задач из тематических веток (временных веток 
наподобие І5553), чтобы удостовериться, что эти изменения проходят все тесты и не вызывают 
ошибок. 

В действительности же, мы говорим об указателях, передвигающихся вверх по линии 
коммитов, которые вы делаете. Стабильные ветки далеко внизу линии вашей истории коммитов, 
наиболее свежие ветки находятся ближе к верхушке этой линии (смотри Рисунок 3-18). 



тамег I I <1«ѵ«к>р I юр*с 




Рисунок 3.18: Более стабильные ветки, как правило, находятся дальше в истории коммитов. 

В общем, об этом проще думать как о силосных башнях, где набор коммитов переходит 
в более стабильную башню только тогда, когда он полностью протестирован (смотри Рисунок 
3-19). 

Вы можете применять эту идею для нескольких разных уровней стабильности. Некоторые 
большие проекты также имеют ветку ргорозесі или ри (ргоровесі ирааіез — предлагаемые 
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тазіег 



сіеѵеіор 
Горіс 

Рисунок 3.19: Может быть полезным думать о ветках как о силосных башнях. 

изменения), которые включают в себя ветки, не готовые для перехода в ветку пехі: или таз - 
1:ег. Идея такова, что ваши ветки находятся на разных уровнях стабильности; когда они 
достигают более высокого уровня стабильности, они сливаются с веткой, стоящей на более 
высоком уровне. Опять-таки, не обязательно иметь долгоживущие ветки, но часто это очень 
полезно, особенно когда вы имеете дело с очень большими и сложными проектами. 

3.4.2 Тематические ветки 

Тематические ветки, однако, полезны в проектах любого размера. Тематическая ветка — 
недолговечная ветка, которую вы создаете и используете для некоторой отдельной возможности 
или вспомогательной работы. Это то, чего вы, вероятно, никогда не делали с системами управления 
версиями раньше, так как создание и слияние веток обычно слишком затратно. Но в Сіі принято 
создавать ветки, работать над ними, объединять и удалять их по несколько раз в день. 

Вы видели подобное в последнем разделе, где вы создавали ветки І5553 и Иоіі^іх. Вы 
сделали несколько коммитов на этих ветках и удалили их сразу после объединения с вашей 
основной веткой. Такая техника позволяет вам быстро и полноценно переключать контекст. 
Когда все изменения в данной ветке относятся к определённой теме, достаточно просто отслеживать, 
что происходило во время работы с кодом. Вы можете сохранить там изменения на несколько 
минут, дней или месяцев, а затем, когда они готовы, слить их с основной веткой, независимо 
от порядка, в котором их создавали или работали над ними. 

Рассмотрим пример, когда выполняется некоторая работа (в ветке тазііе г), делается ответвление 
для решения проблемы (І5591), выполняется немного работы на ней, делается ответвление 
второй ветки для другого пути решения той же задачи (І5 59ІѴ2), осуществляется переход 
назад на вашу основную ветку (таз 1: е г) и выполнение работы на ней, затем делается ответвление 
от неё для выполнения чего-то, в чём вы не уверены, что это хорошая идея (ветка сІитЬісІеа). 
Ваша история коммитов будет выглядеть примерно так как на Рисунке 3-20. 

Теперь представим, вы решили, что вам больше нравится второе решение для вашей задачи 
(І559ІѴ2); и вы показываете ветку сІишЬісІеавашим коллегам и оказывается, что она просто 
гениальна. Так что вы можете выбросить оригинальную ветку І5 591 (теряя при этом коммиты 
С5 и С6) и слить две другие. Тогда ваша история будет выглядеть как на Рисунке 3-21. 

Важно запомнить, что когда вы выполняете все эти действия, ветки являются полностью 
локальными. Когда вы выполняете ветвление и слияние, всё происходит только в вашем репозитории 
— связь с сервером не осуществляется. 
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Рисунок 3.20: История коммитов с несколькими тематическими ветками. 




Рисунок 3.21: Ваша история после слияния йитЫАеа и Івз91ѵ2. 



3.5 Удалённые ветки 



Удалённые ветки — это ссылки на состояние веток в ваших удалённых репозиториях. Это 
локальные ветки, которые нельзя перемещать; они двигаются автоматически всякий раз, когда 
вы осуществляете связь по сети. Удалённые ветки действуют как закладки для напоминания 
о том, где ветки в удалённых репозиториях находились во время последнего подключения к 
ним. 

Они выглядят как ( имя удал . репоз .)/( ветка). Например, если вы хотите 
посмотреть, как выглядела ветка та5Г_ег на сервере огідіп во время последнего соединения 
с ним, проверьте ветку о г ід іп /таз г_ е г . Если вы с партнёром работали над одной проблемой, 
и он выложил ветку І5553, у вас может быть своя локальная ветка І5553; но та ветка на 
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сервере будет указывать на коммит в огідіп/ І5553. 

Всё это, возможно, сбивает с толку, поэтому давайте рассмотрим пример. Скажем, у вас 
есть Сіі-сервер в сети на діі: . оигсотрапу . сот. Если вы склонируете (сіопе) с него, Сіт 
автоматически назовёт его для вас огідіп, заберёт с него все данные, создаст указатель на 
его ветку шазііег и назовёт его локально огідіп/тазііег (но вы не можете его двигать). 
Сіі также сделает вам вашу собственную ветку тазііег, которая будет начинаться там же, где 
и ветка тазііег в огі§іп, так что вам будет с чем начать работать (смотри Рис. 3-22). 



діі. оигсотрапу. сот 



( 0Ь743 ( а6Ь4с ^ -«- ^Лгсз ) 



%іі сіопе 5спасоп@віІ. оигсотрапу. сот:ргоз'есІ.(;іІ 



Му Сотриіег 



огідт/таяег 



^ 0Ь743 ( а6Ыс^ -»- ^Т42с5 ^ 



Ветоіе Вгапсіі 



Ьоса! Вгапсп 



Рисунок 3.22: Клонирование Ск-проекта даёт вам собственную ветку тазіег и огідіп/тазсег, 
указывающий на ветку тазіег в огідіп. 



Если вы сделаете что-то в своей локальной ветке шазііег, а тем временем кто-то ещё 
отправит (ривЬ) изменения на діі: . оигсотрапу . сот и обновит там ветку тавіег, то ваши 
истории продолжатся по-разному. К тому же, до тех пор, пока вы не свяжетесь с сервером 
огі§іп, ваш указатель огідіп/тазііег не будет сдвигаться (смотри Рисунок 3-23). 



діі оигсотрапу сот 



( 0Ь743 )■*— ( абМс"^-*-^ Я2сі ^ЗІЫт )•*— ( " 0а3 )** 



Эотеопе е*5в роапез 



Му Сотриіег 



( 0Ь743 ) •*- ( а6Ь4с*^ 




Рисунок 3.23: При выполнении локальной работы и отправке кем-то изменений на удалённый сервер 
каждая история продолжается по-разному. 



Для синхронизации вашей работы выполняется команда діі: 'ГеІісИ огідіп. Эта 
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команда ищет, какому серверу соответствует огі§іп (в нашем случае это діі: . оигсошрапу . сот); 
извлекает оттуда все данные, которых у вас ещё нет, и обновляет ваше локальное хранилище 
данных; сдвигает указатель огідіп/тазііег на новую позицию (смотри Рисунок 3-24). 



дК.оигсотрапу.сот 



( 0Ь743 ) ■*- ( а6Ь4с ^ -«— ( І*2сР) -*- ^31Ь8е ^ІЭОаЗ ) 



8ІІ *еІсЬ огі^іп 



Му Сотриіег 



( 0Ь743 ( а6Ь4с У 




Рисунок 3.24: Команда діі (еісН обновляет ваши удалённые ссылки. 

Чтобы продемонстрировать то, как будут выглядеть удалённые ветки в ситуации с несколькими 
удалёнными серверами, предположим, что у вас есть ещё один внутренний Сіі-сервер, который 
используется для разработки только одной из ваших команд разработчиков. Этот сервер находится 
на діі: . 1:еат1 . оигсошрапу . сот. Вы можете добавить его в качестве новой удалённой 
ссылки на проект, над которым вы сейчас работаете с помощью команды діі: гетоііе асІСІ 
так же, как было описано в Главе 2. Дайте этому удалённому серверу имя 1:еатопе, которое 
будет сокращением для полного ІЖЬ (смотри Рисунок 3-25). 



дК.оигсотрапу.сот 



дгмеаті .оигсотрапу.сот 



•» - -( <42сГ*)-«— ("зіЬ8ѳ ^ 



ЙІ*. гетоіе лМ Тітппі тоаті . оигсошрапу. сог 



Му Сотриіег 




Рисунок 3.25: Добавление дополнительного удалённого сервера. 
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Теперь можете выполнить діг_ Те\:сЬ г_еатопе, чтобы извлечь всё, что есть на сервере 
и нет у вас. Так как в данный момент на этом сервере есть только часть данных, которые 
есть на сервере огідіп, Оіі не получает никаких данных, но выставляет удалённую ветку 
с именем г_еатопе/та5І:ег, которая указывает на тот же коммит, что и ветка та5Г_ег на 
сервере г_еатопе (смотри Рисунок 3-26). 



ді! оигсотрапу сот 



► -- ^ »2с5 ) •*- ( Э'Ьа» ) ■*- ( ИОаГ) 



огідіп 



діиеаті .оигсотрапу.сот 



^еІсЬ Іеатопс 



Т 



Му Со триіег 




кмом/мйи 


огідт/тімег 




1 

^ 0Ь74 3 ^-«— ^"а6Ь4с ^ «2с5 ( ЗІЬВс 


—( 190аЭ ) 


( аЗЙгіе )ч ^ в93с< ) 

і 









Рисунок 3.26: У вас появилась локальная ссылка на ветку тавіег на іеатопе-е. 



3.5.1 Отправка изменений 

Когда вы хотите поделиться веткой с окружающими, вам необходимо отправить (ривп) её 
на удалённый сервер, на котором у вас есть права на запись. Ваши локальные ветки автоматически 
не синхронизируются с удалёнными серверами — вам нужно явно отправить те ветки, которыми 
вы хотите поделиться. Таким образом, вы можете использовать свои личные ветки для работы, 
которую вы не хотите показывать, и отправлять только те тематические ветки, над которыми 
вы хотите работать с кем-то совместно. 

Если у вас есть ветка 5егѵег"Ріх, над которой вы хотите работать с кем-то ещё, вы 
можете отправить её точно так же, как вы отправляли вашу первую ветку. Выполните діг_ 
ризИ (удал, сервер) (ветка): 



$ діі ризН огідіп зегѵег^Гіх 
Соипіііпд о^ес^в: 20, сіопе. 
Сотргеззіпд о^ес^з: 100% (14/14), сіопе. 
Іл/гіЬіпд оЬзесИз: 100% (15/15), 1.74 КіВ, сіопе. 
ТоГаІ 15 (сіеІИа 5), геизесі Ѳ (сІеІСа 0) 
То діі§ді1:ІіиЬ . сот : зсМасоп/зітрІедіі . діт: 
* [пем ЬгапсН] зегѵег^іх -> зегѵег^іх 



Это в некотором роде сокращение. Сіі автоматически разворачивает имя ветки зегѵег - 
т"іх до гет"5/гіеасІ5/5егѵегт"іх : гет"5/гіеасІ5/5егѵегт"іх, что означает «возьми мою 
локальную ветку вегѵеггіх и обнови из неё удалённую ветку вегѵеггіх». Мы подробно обсудим 
часть с ге^з/НеасІз/ в Главе 9, но обычно можно её опустить. Вы можете сделать также 
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діі. ризгі огідіп зегѵег^іх : зегѵег^іх, что означает то же самое — здесь говорится 
«возьми мой зегѵегйх и сделай его удалённым зегѵегйх». Можно использовать этот формат 
для отправки локальной ветки в удалённую ветку, которая называется по-другому Если вы 
не хотите, чтобы ветка называлась зегх/ег'Пх на удалённом сервере, то вместо предыдущей 
команды выполните діі: ризгі огідіп зегѵег^іх : амезотеЬгапсгі. Так ваша локальная 
ветка зегѵег^іх отправится в ветку аиезотеЬгапсгі удалённого проекта. 

В следующий раз, когда один из ваших соавторов будет получать обновления с сервера, 
он получит ссылку на то, на что указывает зегѵег^іх на сервере, как удалённую ветку огі- 
діп/зегѵег^іх: 

$ діі т"ег.сІі огідіп 
гетог.е: СоипИпд оЬзесг.5: 20, сіопе. 
гетог.е: Сотргеззіпд оЬзесГ.з: 100% (14/14), сіопе. 
гетог.е: Тог.а1 15 (деНа 5), геизесі Ѳ ( сіе11:а 0) 
ІІпраскіпд оЬзесіз: 1ѲѲ% (15/15), сіопе. 
Ргот діі@ді1:ИиЬ . сот : зсНасоп/зітрІедіІ: 
* [пем ЬгапсИ] зегѵегг"іх -> огідіп/зегѵег^Гіх 




Важно отметить, что когда при получении данных у вас появляются новые удалённые 
ветки, вы не получаете автоматически для них локальных редактируемых копий. Другими 
словами, в нашем случае вы не получите новую ветку зегѵеггіх — только указатель огі- 
діп/зегѵег^іх, который вы не можете менять. 

Чтобы слить эти наработки в вашу текущую рабочую ветку, можете выполнить д і і шегде 
огідіп/зегѵег^іх. Если вы хотите иметь собственную ветку зегх/ег'Пх, над которой вы 
сможете работать, можете создать её на основе удалённой ветки: 



$ діг. сПескоиг. -Ь зегѵег^Гіх огідіп/зегѵег^Гіх 

ВгапсИ зегѵегт"іх зеі ир г.о Г.гаск гето1:е ЬгапсИ ге^Гз/гетоІіез/огідіп/зегѵег^іх . 
5міг.сІіесІ 1:о а пем ЬгапсИ "зегѵег^Гіх" 




Это даст вам локальную ветку, на которой можно работать. Она будет начинаться там, где 
и огідіп/зегѵег^іх. 

3.5.2 Отслеживание веток 

Получение локальной ветки с помощью діі: сИескои1:из удалённой ветки автоматиче ски 
создаёт то, что называется отслеживаемой веткой. Отслеживаемые ветки — это локальные 
ветки, которые напрямую связаны с удалённой веткой. Если, находясь на отслеживаемой ветке, 
вы наберёте діі: риз И, Сіі уже будет знать, на какой сервер и в какую ветку отправлять 
изменения. Аналогично выполнение діі риіі на одной из таких веток сначала получает 
все удалённые ссылки, а затем автоматически делает слияние с соответствующей удалённой 
веткой. 

При клонировании репозитория, как правило, автоматически создаётся ветка тазііег, 
которая отслеживает огідіп/шазііег, поэтому діі ризИ и діі риіі работают для этой 
ветки «из коробки» и не требуют дополнительных аргументов. Однако, вы можете настроить 
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отслеживание и других веток удалённого репозитория. Простой пример, как это сделать, вы 
увидели только что — діг. сНескоиг. -Ь [ветка] [удал, сервер] /[ветка]. Если 
вы используете Сіі версии 1.6.2 или более позднюю, можете также воспользоваться сокращением 
- -Г-гаск: 

$ діі спескоиі: --1:гаск огідіп/зегѵег^Гіх 

Вгапсіі зегѵегт"іх зеі ир Ьо Ігаск гето1:е ЬгапсЬ ге^Гз/гетоІез/огідіп/зегѵег^іх . 
ЗмИсИес! 1:о а пей Ьгапсп "зегѵег^Гіх" 



Чтобы настроить локальную ветку с именем, отличным от имени удалённой ветки, вы 
можете легко использовать первую версию с другим именем локальной ветки: 

$ діі сііескоиі: -Ь зт' огідіп/зегѵег^Гіх 

ВгапсИ зт" зеі: ир Со ігаск гето!:е Ьгапсіі ге^з/гето^ез/огідіп/зегѵег^іх . 
ЗмИсІіесІ Ьо а пем ЬгапсИ "з'Р" 



Теперь ваша локальная ветка 5і будет автоматически отправлять (ривЬ) и получать (риіі) 
изменения из огі§іп/зегѵег!іх. 

3.5.3 Удаление веток на удалённом сервере 

Скажем, вы и ваши соавторы закончили с нововведением и слили его в ветку та5Г_ег на 
удалённом сервере (или в какую-то другую ветку, где хранится стабильный код). Вы можете 
удалить ветку на удалённом сервере, используя несколько бестолковый синтаксис діг. ризп 
[удал, сервер] : [ветка]. Чтобы удалить ветку зегѵег^іх на сервере, выполните 
следующее: 

$ діі ризИ огідіп ізегѵег^іх 
То діі§ді1:ИиЬ . сот : зсііасоп/зітріедіі . діт: 
- [сіеіе^есі] зегѵегг"іх 

Хлоп. Нет больше ветки на вашем сервере. Вам может захотеться сделать закладку на 
текущей странице, так как эта команда вам понадобится, а синтаксис вы, скорее всего, забудете. 
Можно запомнить эту команду вернувшись к синтаксису діг_ риз И [удал. сервер] 
[лок . ветка] : [удал . ветка], который мы рассматривали немного раньше. Опуская 
часть [лок. ветка], вы по сути говорите «возьми ничто в моём репозитории и сделай так, 
чтобы в [удал . ветка] было то же самое». 

3.6 Перемещение 

В С-іг есть два способа включить изменения из одной ветки в другую: те где (слияние) и 
геЬазе (перемещение). В этом разделе вы узнаете, что такое перемещение, как его осуществлять, 
почему это удивительный инструмент и в каких случаях вам не следует его использовать. 
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3.6.1 Основы перемещения 

Если вы вернетесь назад к примеру из раздела Слияние (смотри Рисунок 3-27), вы увидите, 
что вы разделили вашу работу на два направления и выполняли коммиты на двух разных 
ветках. 



ехр«гітет 




танег 

Рисунок 3.27: Впервые разделенная история коммитов. 

Наиболее простое решение для объединения веток, как мы уже выяснили, команда те г д е. 
Эта команда выполняет трехходовое слияние между двумя последними снимками состояний 
из веток (СЗ и С4) и последним общим предком этих двух веток (С2), создавая новый снимок 
состояния (и коммит), как показано на Рисунке 3-28. 



ехрвгітет 




та$мг 

Рисунок 3.28: Слияние ветки для объединения разделившейся истории разработки. 

Однако, есть и другой путь: вы можете взять изменения, представленные в СЗ, и применить 
их сверху С4. В Сіі это называется перемещение (геЬазіп§). При помощи команды геЬазе вы 
можете взять все изменения, которые попали в коммиты на одной из веток, и повторить их на 
другой. 

В этом примере вы выполните следующее: 

$ діі сііескоиі: ехрегітепі: 
$ діі геЬазе таз1:ег 

Рігзі, геиіпсііпд НеасІ іо геріау уоиг могк оп іор оТ ІС... 
Арріуіпд: асісіесі зііадесі соттапсі 

Это работает следующим образом: находится общий предок для двух веток (на которой вы 
находитесь сейчас и на которую вы выполняете перемещение); берётся разница, представленная 
в каждом из коммитов на текущей ветке, и сохраняется во временные файлы; текущая ветка 
устанавливается на такой же коммит, что и ветка, на которую вы выполняете перемещение; 
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и, наконец, последовательно применяются все изменения. Рисунок 3-29 иллюстрирует этот 
процесс. 




Рисунок 3.29: Перемещение изменений, сделанных в СЗ, на С4. 

На этом этапе можно переключиться на ветку тавіег и выполнить слияние-перемотку 
(Тазі-йгѵѵага тег§е) (смотри Рисунок 3-30). 



ехрегітет 




Рисунок 3.30: Перемотка ветки тазіег. 



Теперь снимок состояния, на который указывает СЗ, точно такой же, что тот, на который 
указывал С5 в примере со слиянием. Нет никакой разницы в конечном результате объединения, 
но перемещение выполняется для того, чтобы история была более аккуратной. Если вы посмотрите 
лог (1о§) перемещенной ветки, то увидите, что он выглядит как линейная история работы: 
выходит, что вся работа выполнялась последовательно, когда в действительности она выполнялась 
параллельно. 

Часто вы будете делать это, чтобы удостовериться, что ваши коммиты правильно применяются 
для удаленных веток — возможно для проекта, владельцем которого вы не являетесь, но в 
который вы хотите внести свой вклад. В этом случае вы будете выполнять работу в ветке, а 
затем, когда будете готовы внести свои изменения в основной проект, выполните перемещение 
вашей работы на огідіп/тазііег. Таким образом, владельцу проекта не придется делать 
никаких действий по объединению — просто перемотка (!а5І-!ог\ѵага) или чистое применение 
патчей. 

Заметьте, что снимок состояния, на который указывает последний коммит, который у вас 
получился, является ли этот коммит последним перемещенным коммитом (для случая выполнения 
перемещения) или итоговым коммитом слияния (для случая выполнения слияния), есть один 
и тот же снимок — разной будет только история. Перемещение применяет изменения из одной 
линии разработки в другую в том порядке, в котором они были представлены, тогда как слияние 
объединяет вместе конечные точки двух веток. 

3.6.2 Более интересные перемещения 

Вы также можете выполнять перемещение не только для перемещения ветки. Возьмём, 
например, историю разработки как на Рисунке 3-31. Вы создали тематическую ветку (5ѲГѴѲ г), 
чтобы добавить в проект некоторый функционал для серверной части, и сделали коммит. Затем 
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вы выполнили ответвление, чтобы сделать изменения для клиентской части, и несколько раз 
выполнили коммиты. Наконец, вы вернулись на ветку вегѵег и сделали ещё несколько коммитов. 



таЯег 




сііет 



Рисунок 3.31: История разработки с тематической веткой, ответвленной от другой тематической 
ветки. 

Предположим, вы решили, что хотите внести ваши изменения для клиентской части в 
основную линию разработки для релиза, но при этом хотите оставить в стороне изменения для 
серверной части, пока они не будут полностью протестированы. Вы можете взять изменения 
из ветки сііепі, которых нет на вегѵег (С8 и С9), и применить их на ветке тавіег при помощи 
опции - -оп 1:о команды діі: геЬазе: 

$ діі геЬазе --опіо тазГег зегѵег сііепі; 

По сути, это указание «переключиться на ветку сііепі, взять изменения от общего предка 
веток сііепі: и зегѵег и повторить их на тазііег». Это немного сложно; но результат, 
показанный на Рисунке 3-32, достаточно классный. 



таяег сііет 




Рисунок 3.32: Перемещение тематической ветки, ответвленной от другой тематической ветки. 

Теперь вы можете выполнить перемотку (іазі-йгѵѵага) для вашей ветки тазіег (смотри 
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Рисунок 3-33): 



$ діі сИескоиІ: таз(:ег 
$ діі тегде сііепі: 



сііет 



I 




5егѵег 



Рисунок 3.33: Перемотка ветки тазіег, чтобы включить изменения из ветки сііепі. 

Представим, что вы также решили включить ветку вегѵег в основную ветку. Вы можете 
выполнить перемещение ветки аегѵег на ветку тазіег без предварительного переключения на 
эту ветку при помощи команды ді г. геЬазе [осн. ветка] [тем. ветка] — которая 
устанавливает тематическую ветку (в данном случае зегѵег) как текущую и применяет её 
изменения на основной ветке (та5Г_ег): 

$ діі геЬазе тазСег зегѵег 

Эта команда применит изменения из вашей работы над веткой зегѵег на вершину ветки 
та5Г_ег, как показано на Рисунке 3-34. 




Рисунок 3.34: Перемещение вашей ветки зегѵег на вершину ветки тавіег. 
Затем вы можете выполнить перемотку ({азі-гогѵѵага) основной ветки (та5Г_ег): 

$ діі сііескоиі: тазііег 
$ діі тегде зегѵег 

Вы можете удалить ветки сііепі: и зегѵег, так как вся работа из них включена в основную 
линию разработки и они вам больше не нужны. При этом полная история вашего рабочего 
процесса выглядит как на Рисунке 3-35: 
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Рисунок 3.35: Финальная история коммитов. 



3.6.3 Возможные риски перемещения 

Все бы хорошо, но кое-что омрачает всю прелесть использования перемещения. Это 
выражается одной строчкой: 

Не перемещайте коммиты, которые вы выложили в публичный репозиторий. 

Если вы будете следовать этому указанию, все будет хорошо. Если нет — люди возненавидят 
вас, вас будут презирать ваши друзья и семья. 

Когда вы что-то перемещаете, вы отменяете существующие коммиты и создаете новые, 
которые являются похожими на старые, но в чем-то другими. Если вы выкладываете ваши 
коммиты куда-нибудь, и другие забирают их себе и в дальнейшем основывают на них свою 
работу, а затем вы переделываете эти коммиты командой діі: геЬазе и выкладываете их 
снова, ваши коллеги будут вынуждены заново выполнять слияние для своих наработок. Все 
запутается, когда вы в очередной раз попытаетесь включить их работу в свою. 

Давайте рассмотрим пример того, как выполненное вами перемещение наработок, представленных 
для общего доступа, может вызвать проблемы. Представьте себе, что вы клонировали себе 
репозиторий с центрального сервера и поработали в нем. Ваша история коммитов выглядит 
как на Рисунке 3-36. 

діиеагтИ .оигсотрапу.сот 




таяег 



Рисунок 3.36: Клонирование репозитория и выполнение в нём какой-то работы. 

Теперь кто-то ещё выполняет работу, причём работа включает в себя и слияние, и отправляет 
свои изменения на центральный сервер. Вы извлекаете их и сливаете новую удалённую ветку 
со своей работой. Тогда ваша история выглядит как на Рисунке 3-37. 
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дімеаглі .оигсотрапу.сот 




Рисунок 3.37: Извлечение коммитов и слияние их со своей работой. 

Далее, человек, выложивший коммит, содержащий слияние, решает вернуться и вместо 
слияния (гдег§е) переместить (геЬаве) свою работу; он выполняет діі ризИ - - 'Рогсе, чтобы 
переписать историю на сервере. Затем вы извлекаете изменения с этого сервера, включая и 
новые коммиты. 



дімеаглі .оигсотрапу.сот 




Рисунок 3.38: Кто-то выложил перемещённые коммиты, отменяя коммиты, на которых вы 
основывали свою работу. 



На этом этапе вы вынуждены объединить эту работу со своей снова, даже если вы уже 
сделали это ранее. Перемещение изменяет у этих коммитов 5НА-1 хеши, так что для Сіі они 
выглядят как новые коммиты, тогда как на самом деле вы уже располагаете наработками С4 в 
вашей истории (смотри Рисунок 3-39). 

Вы вынуждены объединить эту работу со своей на каком-либо этапе, чтобы иметь возможность 
продолжать работать с другими разработчиками в будущем. После того, как вы сделаете это, 
ваша история коммитов будет содержать оба коммита — С4 и С4', которые имеют разные 5НА- 
1 хеши , но представляют собой одинаковые изменения и имеют одинаковые сообщения. Если 
вы выполните команду діі. Іод, когда ваша история выглядит таким образом, вы увидите 
два коммита, которые имеют одинакового автора и одни и те же сообщения. Это сбивает с 
толку. Более того, если вы отправите такую историю обратно на сервер, вы добавите все эти 
перемещенные коммиты в репозиторий центрального сервера, что может ещё больше запутать 
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дімеаті .оигсотрапу.сот 




Рисунок 3.39: Вы снова выполняете слияние для той же самой работы в новый коммит слияния. 
людей. 

Если вы рассматриваете перемещение как возможность наведения порядка и работы с 
коммитами до того, как выложили их, и если вы перемещаете только коммиты, которые никогда 
не находились в публичном доступе — всё нормально. Если вы перемещаете коммиты, которые 
уже были представлены для общего доступа, и люди, возможно, основывали свою работу на 
этих коммитах, тогда вы можете получить наказание за разные неприятные проблемы. 

3.7 Итоги 

Мы рассмотрели основы ветвления и слияния в Сіі. Вы должны чувствовать себя уверенно 
при создании и переходе на новые ветки, переключении между ветками и слиянии локальных 
веток. Вы также должны иметь возможность делиться своими ветками, выкладывая их на 
общий сервер, работать с другими людьми над общими ветками и перемещать свои ветки до 
того, как они были представлены для общего доступа. 



75 



Глава 4 



Ск на сервере 



К этому моменту вы уже должны уметь делать большую часть повседневных задач, для 
которых вы будете использовать Сіі. Однако, для совместной работы в Сіі, вам необходим 
удаленный репозиторий. Несмотря на то, что технически вы можете отправлять и забирать 
изменения непосредственно из личных репозиториев, делать это не рекомендуется. Вы легко 
можете испортить то, над чем работают другие, если не будете аккуратны. К тому же, вам бы 
наверняка хотелось, чтобы остальные имели доступ к репозиторию даже если ваш компьютер 
выключен, поэтому наличие более надежного репозитория обычно весьма полезно. Поэтому 
предпочтительный метод взаимодействия с кем-либо — это создание промежуточного репозитория, 
к которому вы оба будете иметь доступ, и отправка и получение изменений через него. Мы 
будем называть этот репозиторий «сервер Сіі», но обычно размещение репозитория С-іі требует 
очень небольшого количества ресурсов, поэтому вряд ли вам для этого будет нужен весь сервер. 

Запустить С-іГ-сервер просто. Для начала вам следует выбрать протокол, который вы будете 
использовать для связи с сервером. Первая часть этой главы описывает доступные протоколы и 
их достоинства и недостатки. Следующие части освещают базовые конфигурации с использованием 
этих протоколов, а также настройку вашего сервера для работы с ними. Наконец, мы рассмотрим 
несколько вариантов готового хостинга, если вы не против разместить ваш код на чьем-то 
сервере и вы не хотите мучиться с настройками и поддержкой вашего собственного сервера. 

Если вас не интересует настройка собственного сервера, вы можете перейти сразу к последней 
части этой главы для настройки аккаунта на С-іГ-хостинге, и затем перейти к следующей главе, 
где мы обсудим различные аспекты работы с распределенной системой контроля версий. 

Удаленный репозиторий — это обычно голый (чистый, Ьаге) репозиторий — репозиторий 
Сіі, не имеющий рабочего каталога. Поскольку этот репозиторий используется только для 
обмена, нет причин создавать рабочую копию на диске, и он содержит только данные Сіі. 
Проще говоря, голый репозиторий содержит только каталог . діі вашего проекта и ничего 
больше. 

4.1 Протоколы 

Сіх умеет работать с четырьмя сетевыми протоколами для передачи данных: локальный, 
Зесиге ЗЬеІІ (55Н), С-іГ и НТТР. В этой части мы обсудим каждый из них и в каких случаях 
стоит (или не стоит) их использовать. 

Важно понимать, что за исключением протокола НТТР, все эти протоколы требуют, чтобы 
С-іГ был установлен и работал на сервере. 
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4.1.1 Локальный протокол 

Базовым протоколом является Локальный протокол, при использовании которого удаленный 
репозиторий — другой каталог на диске. Наиболее часто он используется, если все члены 
команды имеют доступ к общей файловой системе, например к №5, или, что менее вероятно, 
когда все работают на одном компьютере. Последний вариант не столь хорош, поскольку все 
копии вашего репозитория находятся на одном компьютере, делая возможность потерять все 
более вероятной. 

Если у вас смонтирована общая файловая система, вы можете клонировать, отправлять и 
получать изменения из локального репозитория. Чтобы склонировать такой репозиторий или 
добавить его в качестве удаленного в существующий проект, используйте путь к репозиторию 
в качестве ІЖЬ. Например, для клонирования локального репозитория вы можете выполнить 
что-то вроде этого: 

$ діі сіопе /оріі/діі/ргозесі: . діі 



Или этого: 

$ діі сіопе -Гі1е:///ор1:/ді1:/рго]ес(:.ді1: 

Сіі работает немного по-другому если вы укажете префикс 'Гііе : / / для вашего ІШЬ. 
Когда вы просто указываете путь, СіІ пытается использовать жесткие ссылки и копировать 
файлы, когда это нужно. Если вы указываете ТІІе : //, Сіі работает с данными также как при 
использовании сетевых протоколов, что в целом менее эффективный способ передачи данных. 
Причиной для использования Тііе : // может быть необходимость создания чистой копии 
репозитория без лишних внешних ссылок и объектов, обычно после импорта из другой СУВ 
или чего-то похожего (см. главу 9 о задачах поддержки). Мы будем использовать обычные 
пути, поскольку это практически всегда быстрее. 

Чтобы добавить локальный репозиторий в существующий проект, вы можете воспользоваться 
командой: 

$ діі гето1:е асісі 1оса1_ргоз /орІ/дИ/ргсоесІ: .діХ. 



Теперь вы можете отправлять и получать изменения из этого репозитория так, как вы это 
делали по сети. 

Преимущества Преимущества основанных на файлах хранилищ в том, что они просты и 
используют существующие разграничения прав на файлы и сетевой доступ. Если у вас уже 
есть общая файловая система, доступ к которой имеет вся команда, настройка репозитория 
очень проста. Вы помещаете голый репозиторий туда, куда все имеют доступ, и выставляете 
права на чтение и запись, как вы бы это сделали для любого другого общего каталога. Мы 
обсудим, как экспортировать голую копию репозитория для этой цели в следующем разделе, 
«Установка СіІ на сервер». 
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Также это хорошая возможность быстро получить наработки из чьего-то рабочего репозитория. 
Если вы и ваш коллега работаете над одним и тем же проектом и он хочет, чтобы вы проверили 
что-то, то запуск команды вроде діі риіі /Ьоте/] оНп/ргсд есі: зачастую проще, чем 
если бы он отправил на удалённый сервер, а вы забрали бы оттуда. 

Недостатки Недостаток этого метода в том, что общий доступ обычно сложнее настроить и 
получить из разных мест, чем простой сетевой доступ. Если вы хотите отправлять со своего 
ноутбука, когда вы дома, вы должны смонтировать удалённый диск, что может быть сложно и 
медленно по сравнению с сетевым доступом. 

Также важно упомянуть, что не всегда использование общей точки монтирования является 
быстрейшим вариантом. Локальный репозиторий быстрый, только если вы имеете быстрый 
доступ к данным. Репозиторий на часто медленнее, чем репозиторий через 55Н на том 
же сервере, позволяющий СИ'у использовать на полную локальные диски на каждой системе. 

4.1.2 Протокол 88Н 

Наверное, наиболее часто используемый транспортный протокол — это 55Н. Причина 
этого в том, что доступ по 55Н уже есть на многих серверах, а если его нет, то его очень 
легко настроить. Кроме того, 38Н — единственный из сетевых протоколов, предоставляющий 
доступ и на чтение, и на запись. Два других сетевых протокола (НТТР и СіГ) в большинстве 
случаев дают доступ только на чтение, поэтому даже если они вам доступны, вам все равно 
понадобится 55Н для записи. К тому же 55Н протокол с аутентификацией, и благодаря его 
распространенности обычно его легко настроить и использовать. 

Чтобы склонировать СіІ-репозиторий по 55Н, вы можете указать префикс ббЬ:// в ЦКЕ, 
например: 

$ діі сіопе 55И://изег@5егѵег:ргозес1:.діІ: 



Или вы можете не указывать протокол, СіГ подразумевает использование 55Н, если вы не 
указали протокол явно: 



$ діі сіопе изег§зегѵег : ргозесі . ді(: 




Также вы можете не указывать имя пользователя, СіГ будет использовать то, под которым 
вы вошли в систему. 

Достоинства 55Н имеет множество достоинств. Во-первых, вы по сути вынуждены его 
использовать, когда нужен авторизованный доступ на запись к репозиторию через сеть. Во- 
вторых, 55Н достаточно легко настроить — демоны 55Н распространены, многие системные 
администраторы имеют опыт работы с ними, и во многих дистрибутивах они уже настроены 
или есть утилиты для управления ими. Также доступ по 5 5Н безопасен — данные передаются 
зашифрованными по авторизованным каналам. Наконец, так же как и СіІ-протокол и локальный 
протокол, 55Н эффективен, делая данные перед передачей максимально компактными. 
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Недостатки Недостаток 55Н в том, что, используя его, вы не можете обеспечить анонимный 
доступ к репозиторию. Клиенты должны иметь доступ к машине по 55Н, даже для работы в 
режиме только на чтение, что делает 55Н неподходящим для проектов с открытым исходным 
кодом. Если вы используете СіІ только внутри корпоративной сети, то возможно 55Н единственный 
протокол, с которым вам придется иметь дело. Если же вам нужен анонимный доступ на чтение 
для ваших проектов, вам придется настроить 55Н для себя, чтобы выкладывать изменения, и 
что-нибудь другое для других, для скачивания. 

4.1.3 Сіі-протокол 

Следующий протокол — СіІ-протокол. Вместе с СіІ поставляется специальный демон, 
который слушает порт 9418 и предоставляет сервис, схожий с протоколом ббЬ, но абсолютно 
без аутентификации. Чтобы использовать СіГ-протокол для репозитория, вы должны создать 
файл ді1:-ехрог1:-сІаетоп-ок, иначе демон не будет работать с этим репозиторием, но 
следует помнить, что в протоколе отсутствуют средства безопасности. Соответственно, любой 
репозиторий в СіГ может быть либо доступен для клонирования всем, либо не доступен никому. 
Как следствие, обычно вы не можете отправлять изменения по этому протоколу. Вы можете 
открыть доступ на запись, но из-за отсутствия авторизации в этом случае кто угодно, зная ІЖЬ 
вашего проекта, сможет его изменить. В общем, это редко используемая возможность. 

Достоинства СіІ-протокол — самый быстрый из доступных протоколов. Если у вас проект 
с публичным доступом и большой трафик или у вас очень большой проект, для которого не 
требуется авторизация пользователей для чтения, вам стоит настроить демон СіГ для вашего 
проекта. Он использует тот же механизм передачи данных, что и протокол 5 5Н, но без дополнительных 
затрат на кодирование и аутентификацию. 

Недостатки Недостатком СіГ-протокола является отсутствие аутентификации. Поэтому обычно 
не следует использовать этот протокол как единственный способ доступа к вашему проекту. 
Обычно он используется в паре с 55Н для разработчиков, имеющих доступ на запись, тогда как 
все остальные используют діі: : // с доступом только на чтение. Кроме того, это, вероятно, 
самый сложный для настройки протокол. Вы должны запустить собственно демон, не являющийся 
стандартным. Мы рассмотрим его настройку в разделе «СІЮ5І5» этой главы. К тому же, ему 
необходим сервис хіпеіісі или ему подобный, что не всегда легко сделать. Также необходимо, 
чтобы сетевой экран позволял доступ на порт 9418, который не является стандартным портом, 
всегда разрешённым в корпоративных брандмауэрах. За сетевыми экранами крупных корпораций 
этот неизвестный порт обычно заблокирован. 

4.1.4 Протокол НТТР/8 

Последний доступный протокол — НТТР. Прелесть протоколов НТТР и НТТР5 в простоте 
их настройки. По сути, всё, что необходимо сделать — поместить голый репозиторий внутрь 
каталога с НТТР документами, установить обработчик розі: - ирсіаііе и всё (подробнее об 
обработчиках рассказывается в главе 7). Теперь каждый, имеющий доступ к веб-серверу, на 
котором был размещен репозиторий, может его склонировать. Таким образом, чтобы открыть 
доступ к вашему репозиторию на чтение через НТТР, нужно сделать что-то наподобие этого: 
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Вот и всё. Обработчик розі: - ирсіаііе, входящий в состав Сіі по умолчанию, выполняет 
необходимую команду (діі: ирсіаІіе-Бегѵег-ігтРо), чтобы извлечение (йэгсЬ) и клонирование 
(сіопе) по НТТР работали правильно. Эта команда выполняется, когда вы отправляете изменения 
в репозиторий по 55Н. Затем остальные могут склонировать его командой: 



$ діі сіопе Ыір : //ехатріе . сот/ді(:ргозес1: . дИ 

В рассмотренном примере, мы использовали каталог / ѵа г / ѵіѵіѵі/ И 1: сі о с 5 , обычно используемый 
сервером АрасЬе, но вы можете использовать любой веб-сервер, отдающий статические данные, 
расположив голый репозиторий в нужном каталоге. Данные СіІ представляют собой обычные 
файлы (в главе 9 предоставление данных рассматривается более подробно). 

Также возможна настройка Сіі для доступа на запись через НТТР, однако этот способ мало 
распространен и требует от вас настройки \ѴеЬОАѴ. Поскольку этот способ редко используется, 
мы не будем рассматривать его в рамках этой книги. Если вас интересует использование 
НТТР протокола с возможностью записи, вы можете почитать о подготовке репозитория в этой 
статье: гШр : / /ими . кегпеі . огд/риЬ/зо'ГСиаге/зст/дИ/йосз/ИоиСо/зеСир- діі: - зегѵег - оѵег- И1 
ІХІ. Положительным моментом настройки Сіі для записи через НТТР является то, что вы 
можете использовать любой \ѴеЬБАѴ сервер, без поддержки каких-либо специфичных для Сіі 
возможностей. Таким образом если ваш хостинг предоставляет \ѴеЬБАѴ, вы можете обеспечить 
запись обновлений репозитория на ваш веб-сайт. 

Достоинства Положительным аспектом использования протокола НТТР является простота 
настройки. Запуск всего нескольких команд дает вам возможность предоставить миру доступ к 
вашему СіІ-репозиторию. Вам понадобится всего несколько минут, чтобы сделать это. Кроме 
того, использование протокола НТТР не потребует много ресурсов вашего сервера. Поскольку 
в основном используется статический НТТР сервер, обычный сервер АрасЬе может обрабатывать 
в среднем тысячи файлов в секунду — трудно перегрузить даже небольшой сервер. 

Также вы можете выставлять ваши репозиторий в режиме только для чтения через НТТР8, 
т.е. вы можете шифровать трафик, или вы даже можете авторизовать клиентов по 55Ь сертификату. 
Обычно для этих целей легче использовать открытые ключи 55Н, но в некоторых конкретных 
случаях лучшим решением может оказаться использование подписанных 55Ь сертификатов 
или других методов аутентификации основанных на НТТР, для доступа на чтение через НТТРЗ. 

Другим плюсом является то, что НТТР — настолько широко используемый протокол, что 
корпоративные сетевые экраны часто настроены на пропускание трафика, проходящего через 
этот порт. 

Недостатки Обратной стороной использования протокола НТТР является его относительно 
низкая эффективность для клиента. Обычно клонирование или извлечение изменений из репозитория 
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при использовании НТТР гораздо продолжительнее, а объем данных и нагрузка на сеть намного 
больше, чем у любого другого имеющегося сетевого протокола. Поскольку он не заботится о 
том, чтобы передавались только необходимые вам данные — никакой динамической обработки 
на стороне сервера в этом случае не происходит — протокол НТТР часто называют тупым 
(сішгіЪ) протоколом. Более подробно о разнице в эффективности протокола НТТР и других 
протоколов рассказывается в главе 9. 

4.2 Установка Сіі на сервер 

Для того чтобы приступить к установке любого сервера СіГ, вы должны экспортировать 
существующий репозиторий в новый «голый» репозиторий, т.е. репозиторий без рабочего 
каталога. Обычно это несложно сделать. Чтобы склонировать ваш репозиторий и создать 
новый «голый» репозиторий, выполните команду сіопе с параметром - - Ьаг е. По существующему 
соглашению, каталоги с голыми репозиториями заканчиваются на . дІГ., например: 

$ діі сіопе --Ьаге ту_ргозес1: ту_ргозесІ: . діі 



Іпіііаіігесі етрііу Сіі герозііюгу іп /ор1:/рго]ес1:з/ту_рго]ес(: . діі/ 




Вывод этой команды слегка обескураживает. Поскольку сіопе по сути это діі ІПІЪ, а 
затем діі. Теі.сЬ, мы видим вывод от діі. іпіЪ, который создает пустой каталог. Реальное 
перемещение объектов не имеет вывода, однако оно происходит. Теперь у вас должна быть 
копия данных из каталога Сіг в каталоге ту_рго з есі: . діг.. 

Грубо говоря, это что-то наподобие этого: 

$ ср -р-р ту_рго]есі/.ді1: ту_рго]ес(: . діі 

Тут есть пара небольших различий в файле конфигурации, но в вашем случае эту разницу 
можно считать несущественной. Можно считать, что в этом случае берется собственно репозиторий 
СіІ без рабочего каталога и создается каталог только для него. 

4.2.1 Размещение «голого» репозитория на сервере 

Теперь, когда у вас есть голая копия вашего репозитория, всё, что вам нужно сделать, 
это поместить ее на сервер и настроить протоколы. Условимся, что вы уже настроили сервер 
діг. . ехатріе . сот, имеете к нему доступ по 55Н и хотите размещать все ваши репозиторий 
Сіг в каталоге /оргѴдіг.. Вы можете добавить ваш новый репозиторий копированием голого 
репозитория: 

$ зср -г ту_рго]есі . дИ изег§діІ . ехатріе . сот : /орі/діі 

Теперь другие пользователи, имеющие доступ к серверу по 55Н и право на чтение к 
каталогу /орі/діі, могут склонировать ваш репозиторий, выполнив: 
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. ехашріе . сот : /орГѴді1:/ту_рго]ес1: . діі 



Если у пользователя сервера есть право на запись в каталог / о р 1: / д і 1: /ту_р г о з е с 1: . д і 1: , 
он автоматически получает возможность отправки изменений в репозиторий. СіГ автоматически 
добавит право на запись в репозиторий для группы, если вы запустите команду діі ІПІг. с 
параметром - -зНагесІ. 



$ ззИ изег@ді1: . ехатріе . сот 
$ ссі /ор!:/ді(:/ту_ргозес1: .діі: 
$ діі іпіГ. --Ьаге --зііагесі 




Видите, это просто взять репозиторий Сіі, создать «голую» версию и поместить ее на 
сервер, к которому вы и ваши коллеги имеете доступ по 55Н. Теперь вы готовы работать вместе 
над одним проектом. 

Важно отметить, что это практически всё, что вам нужно сделать, чтобы получить рабочий 
Сіг-сервер, к которому несколько человек имеют доступ — просто добавьте учетные записи 
55Н на сервер, и положите голый репозиторий в место, к которому эти пользователи имеют 
доступ на чтение и запись. И всё. 

Из нескольких последующих разделов вы узнаете, как получить более сложные конфигурации. 
В том числе как не создавать учетные записи для каждого пользователя, как сделать публичный 
доступ на чтение репозитория, как установить веб-интерфейс, как использовать Сііобіб, и др. 
Однако, помните, что для совместной работы пары человек на закрытом проекте, всё, что вам 
нужно — это 55Н-сервер и «голый» репозиторий. 

4.2.2 Малые установки 

Если вы небольшая фирма или вы только пробуете СіГ в вашей организации и у вас мало 
разработчиков, то всё достаточно просто. Один из наиболее сложных аспектов настройки 
сервера Сіі — управление пользователями. Если вы хотите, чтобы некоторые репозиторий 
были доступны некоторым пользователям только на чтение, а другие и на чтение, и на запись, 
вам может быть не очень просто привести права доступа в порядок. 

88Н доступ Если у вас уже есть сервер, к которому все ваши разработчики имеют доступ по 
55Н, проще всего разместить ваш первый репозиторий там, поскольку вам не нужно практически 
ничего делать (как мы уже обсудили в предыдущем разделе). Если вы хотите более сложного 
управления правами доступа к вашим репозиториям, вы можете сделать это обычными правами 
файловой системы, предоставляемыми операционной системой вашего сервера. 

Если вы хотите разместить ваши репозиторий на сервер, на котором нет учетных записей 
для каждого в вашей команде, кому нужен доступ на запись, вы должны настроить доступ по 
55Н для них. Будем считать, что если у вас есть сервер, на котором вы хотите это сделать, то 
55Н-сервер на нем уже установлен, и через него вы имеете доступ к серверу. 

Есть несколько способов дать доступ каждому в вашей команде. Первый — настроить 
учетные записи для каждого. Это просто, но может быть весьма обременительно. Вероятно, 
вы не захотите для каждого пользователя выполнять асісіизег и задавать временные пароли. 



83 



Глава 4 Оіі на сервере 



Зсоіі СЬасоп Рго Сіі 



Второй способ — создать на машине одного пользователя попросить каждого пользователя, 
кому нужен доступ на запись, прислать вам открытый ключ 55Н, и добавить эти ключи в 
файл ~/ . 55И/аи1:ИогІ2есІ_кеу5 вашего нового пользователя Теперь все будут иметь 
доступ к этой машине через пользователя Это никак не повлияет на данные коммита 

— пользователь, под которым вы соединяетесь с сервером по 55Н, не затрагивает сделанные 
вами коммиты. 

Другой способ сделать это — использовать 55Н-сервер, аутентифицирующий по ЬБАР- 
серверу или любому другому централизованному источнику, который у вас может быть уже 
настроен. Любой способ аутентификации по 55Н, какой вы только сможете придумать, должен 
работать, если пользователь может получить доступ к консоли. 

4.3 Создание открытого 88Н-ключа 

Как было уже сказано, многие СіГ-серверы используют аутентификацию по открытым 
55Н-ключам. Для того чтобы предоставить открытый ключ, пользователь должен его сгенерировать, 
если только это не было сделано ранее. Этот процесс похож во всех операционных системах. 
Сначала вам стоит убедиться, что у вас ещё нет ключа. По умолчанию пользовательские 55Н- 
ключи хранятся в каталоге ~/ . 5 5 И этого пользователя. Вы можете легко проверить, есть ли 
у вас ключ, зайдя в этот каталог и посмотрев его содержимое: 



$ ссі ~/.ззН 






$ 15 






аи1:Иогі2есі_кеуз2 


ІСІ_ 


_сІ5а кпомп_Но5І:5 


соітГід 


ІСІ_ 


_сІза. риЬ 



Ищите пару файлов с именами «что-нибудь» и «что-нибудь. риЬ», где «что-нибудь» — 

обычно ісі СІ 5 а или ісі г за. Файл с расширением . риЬ — это ваш открытый ключ, а второй 

файл — ваш секретный ключ. Если у вас нет этих файлов (или даже нет каталога . 5 5 И), вы 
можете создать их, запустив программу ззИ - кеудеп, которая входит в состав пакета 55Н в 
системах Ышх/Мас, а также поставляется в составе МЗувС-іГ для Ѵѵіпсіошк: 

$ ззМ-кеудеп 

бепегаііпд риЫіс/ргіѵа1:е гза кеу раіг. 

Еп1:ег ■рііе іп мНісіі (:о заѵе ІИе кеу (/ІІзегз/зсІіасоп/.ззИ/іс1_гза) : 
ЕпЬег раззрИгазе (етріу Тог по раззрпгазе): 
Епіег вате раззрИгазе адаіп: 

Ѵоиг ісіепііі^ісаііоп Ііаз Ьееп заѵесі іп /изегз/5СІіасоп/.ззІѴісІ_г5а. 
Ѵоиг риЫіс кеу Иаз Ьееп заѵесі іп /ІІзегз/зспасоп/.ззп/ісі.гза.рііЬ. 
ТИе кеу ■ріпдегргіпі із: 

43 : с5 : 5Ь : 5Т : Ы : гі : 50 : 43 : асі : 20 : аб : 92 : 6а : 1Т : 9а : За зсИасоп§адасіог1ар1:ор . Іосаі 

Сначала необходимо ввести расположение, для сохранения ключа ( . 5зИ/ісІ_г за), затем 
дважды ввести пароль, который вы можете оставить пустым, если не хотите его вводить каждый 
раз, когда используете ключ. 

Теперь каждый пользователь должен послать свой открытый ключ вам или тому, кто администрирует 
Сіі-сервер (предположим, что ваш 55Н-сервер уже настроен на работу с открытыми ключами). 
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Для этого им нужно скопировать всё содержимое файла с расширением . риЬ и отправить его 
по электронной почте. Открытый ключ выглядит как-то так: 

$ саі ~/.ззН/ісІ_гза.риЬ 

ЗзН-ГЗа ААААВЗN2аС1ус2ЕААААВIиААА^ЕАк10^рк^Н^^НУ175Ь^тТIрN^ТСК9Т^от/ВИ^5^ 

6Р1+па^21н^туи7^1сII4у25е1д/18^н4^ы9^ь^^^р^ѵі^2М7x1Е^Еѵ■Г4^^91РX5^ѵкЬРрр5ид0ссIаз 
рьѵ7кос^^/мтув1иxрсР!+нАозрxрі1:в^xіX1пк^^xрнА2змсі^^8V6к^зNА^^л/с1зс1мрѵ51ѵк/7XА 

1:ЗРао^оАзпсМ1^9x5^-ЗV0Ы1д/68/еIРтЫ2и^Р1^^^Кр^^X88XурN^ѵ^УNЬу6ѵ^л//РЬ0™е^(:/Еп 
т2+АИ402РпТРІ892РтѴМІиауг02сЕ862/і18Ь+дмЗгЗ+1пКаІ:тІкзп2зо1сІѲідгаТ1МдѴ55Ьх 
МгРРі9мг1 = +М7д== зсІіасоп@адасІог1ар(:ор . Іосаі 

Более подробное руководство по созданию 55Н-ключей на различных системах вы можете 
найти в руководстве СііНиЬпо 55Н-ключамна М.Ьр : //ді1:гіиЬ . сот/диісіез/ргоѵісііпд - уоиг - 55И - кеу. 

4.4 Настраиваем сервер 

Давайте рассмотрим настройку доступа по 55Н на стороне сервера. В этом примере 
мы будем использовать метод аи1:ИогІ2есІ_кеу5 для аутентификации пользователей. Мы 
подразумеваем, что вы используете стандартный дистрибутив Ьігшх типа ЦЪшіШ. Для начала 
создадим пользователя '§й' и каталог . 55И для этого пользователя: 

$ зисіо асісіизег д±1 
$ зи діі: 
$ ссі 

$ тксііг . ззіі 

Затем вам нужно добавить открытый 55Н-ключ некоторого разработчика в файл аи - 
1:ИогІ2есІ_кеу5 этого пользователя. Предположим, вы уже получили несколько ключей по 
электронной почте и сохранили их во временные файлы. Напомню, открытый ключ выглядит 
как-то так: 

$ саі /Ітр/ісІ_гзаооМп.рііЬ 

ззИ-гза ААААВЗМ2аС1ус2ЕАААА0АдАВАААВАдСВ0Ѳ7п/ии+оиМ4дЭиК55МхХпВ0ѵт9иеі:4и 
ОЗб6ГЗбИРВѲ9з9К/Т17/х41И0АѲРЗРР1гР6кѴВКзИз2аТІіСм6НХІт9/52уСК621:дЗКРКК+4к 
УЗИ6541МѴзпЕА2иХ2ѲзТТуАУГг1:и325Е003С4охОз6Н0гГІР1кКІ9МАдіМс1рСЫ16ѴЕІд59Е2 
5сI1 = сI8АсСIісТ^ИЬ^^Ас^4^ркаX8Ку61Ил/5Nии621:оЬР8т72А^С/п^Р6^^1:Ро^^^РВ1дс+туіѵ 
О7ТСи5ВсИдідМѴОРд1І2иРИдокОИдАНикЕОт-Гзу2зс1:х5ОВд220утзаМзНТ4кд1:2д2АУУдРд 
сІАѵ8^дЛСІіѵах2Т9ѵа5 дзд-кеураіг 



Вы просто добавляете их в ваш файл аи1:гіогІ2есІ_кеу5: 



$ 


саі 


/ітр/ісІ_ 


_гза. 


ЗОІіп.риЬ » ~/ . ззИ/аи1:Ііогі2есі_кеуз 


$ 


саі 


/ітр/ісІ_ 


_гза. 


ЗОЗіе.риЬ » ~/ . ззИ/аи1:Ііогі2есІ_кеуз 


$ 


саі 


/ітр/ісІ_ 


_гза, 


,Зеззіса.риЬ » ~/ . ззИ/аи1:Иогі2есі_кеуз 
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Теперь вы можете создать пустой репозиторий для них, запустив д і 1: і п і 1: с параметром 
- - Ьаге, что инициализирует репозиторий без рабочего каталога: 

$ ссі /орі/діі 
$ тксііг ргозесі: . діі 
$ ссі ргозесі.діі: 
$ діі --Ьаге іпіі 



Затем Джон, Джози или Джессика могут отправить первую версию своего проекта в этот 
репозиторий, добавив его как удаленный и отправив ветку. Заметьте, что кто-то должен заходить 
на сервер и создавать голый репозиторий каждый раз, когда вы хотите добавить проект. Пусть 
дііізегѵег — имя хоста сервера, на котором вы создали пользователя и репозиторий. 
Если он находится в вашей внутренней сети, вы можете настроить запись БІЧЗ для діі:- 
зегѵег, ссылающуюся на этот сервер, и использовать эти команды: 

# на компьютере Джона 
$ ссі тургозесі: 
$ діИ іпИ 
$ діі асісі . 

$ діі соттіі: -т 'іпіііаі соттіі: 1 

$ діі гето!:е асісі огідіп дИідіІзегѵег : /ор1:/ді(:/ргозес1: . діі 
$ діі ризп огідіп тазіег 




Теперь остальные могут склонировать его и отправлять (ривЬ) туда изменения так же 
легко: 

$ діі сіопе ді1:§ді(:5егѵег : /орі/діі/ргозесі: . діі: 
$ ѵіт КЕАРМЕ 

$ діі соттіі: -ат '-Гіх -Тог 1:пе РЕАОМЕ -Гііе' 
$ діі ризп огідіп тазіег 

Этим способом вы можете быстро получить СіГ-сервер с доступом на чтение/запись для 
небольшой группы разработчиков. 

В качестве дополнительной меры предосторожности вы можете ограничить возможности 
пользователя только действиями, связанными с СіГ, с помощью ограниченной оболочки 
діі: - 5 Иеіі, поставляемой вместе с Сіі. Если вы выставите её в качестве командного интерпретатора 
пользователя то этот пользователь не сможет получить доступ к обычной командной 
оболочке на вашем сервере. Чтобы её использовать, укажите ді1:-5Ие11 вместо ЬавЬ или 
свЬ в качестве командной оболочки пользователя. Для этого вы должны отредактировать файл 
/егх/раззис!: 

$ зиао ѵіт /е1:с/раззысі 
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В конце вы должны найти строку, похожую на эту: 

діГ. : х : ІѲѲѲ : 10Ѳ0 : : /Поте/діГ. : /Ып/вЬ 



Замените /Ьіп/зИ на /изг/Ьіп/діІ: - зИеІІ (или запустите иНісИ ді1:-5гіе11, 
чтобы проверить, куда он установлен). Отредактированная строка должна выглядеть следующим 
образом: 



діі : х : 10ѲѲ : 1000 : : /Ноте/діГ. : /изг/Ьіп/діИ-зИеІІ 




Теперь пользователь может использовать 55Н соединение только для работы с репозиториями 
СіІ и не может зайти на машину. Вы можете попробовать и увидите, что вход в систему 
отклонен: 

$ ззН діг.@ді1:зегѵег 

гаг.а1: ЫИаІ: сіо уои Ііпіпк I ат? А зпеіі? 
Соппесііоп Іо діізегѵег сіозесі. 



4.5 Открытый доступ 

Что, если вы хотите иметь анонимный доступ к вашему проекту на чтение? Возможно, 
вместо размещения внутреннего закрытого проекта, вы хотите разместить проект с открытым 
исходным кодом. Или, может быть, у вас есть автоматизированные серверы сборки или серверы 
непрерывной интеграции, которые часто изменяются, и вы не хотите постоянно перегенерировать 
55Н-КЛЮЧИ, а вы просто хотите добавить анонимный доступ на чтение. 

Вероятно, наиболее простой способ для небольших конфигураций — запустить статический 
веб-сервер, указав в качестве корневого каталога для документов каталог, в котором расположены 
ваши репозитории Сіі, и разрешив хук розі: - ирсіаііе, как было показано в первой части этой 
главы. Давайте продолжим работу с предыдущего примера. Допустим, ваши репозитории 
расположены в каталоге /орІ/дІІ,и сервер АрасЬе запущен на вашей машине. Повторюсь, 
вы можете использовать любой веб-сервер, но в качестве примера мы покажем несколько 
основных конфигураций АрасЬе, которые покажут основную идею. 

Для начала вам следует включить хук: 

$ ссі рго^есі: . діі 

$ тѵ поокз/розіі-ирсіаіе.затріе Иоокз/розіі-ирааіе 
$ сНтосІ а+х Иоокз/розі-ираа1:е 



Если вы используете версию СіГниже 1.6, то команда ШѴ не нужна — добавление суффикса 
.катріе к именам примеров хуков началось только недавно. 
Что делает хук розі: - ирсіаііе? Обычно он выглядит так: 
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$ саі . діІі/Ноокз/розі-ирсІаІіе 
#!/Ьіп/зИ 

ехес ді(:-ирсІа1:е-5егѵег-іп-Го 

Это означает, что когда вы отправляете что-то с помощью діі. ризИна сервер по 55Н, 
СіІ будет запускать эту команду, чтобы обновить файлы необходимые для скачивания по НТТР. 

Затем вы должны добавить запись ѴігШаІНові в конфигурацию вашего АрасЬе с корневым 
каталогом документов в каталоге с вашими проектами СіГ. Здесь мы подразумеваем, что ваш 

сервер настроен на отсылку * . дііізегѵег на ту машину, на которой всё это запущено: 

<Ѵігіиа1Ноз1: *:8Ѳ> 

ЗегѵегМате діі . діізегѵег 
0оситеп1:Коо1: /орі/діі: 
<0ігес1:огу /орі/ді1:/> 
Огсіег аііоы, сіепу 
аііои ■Ггот аіі 
</0ігес1:огу> 
</Ѵігіиа1Ноз1:> 




Вам также понадобится установить Шіх-группу для каталога / орі:/ діі в шм- сіаііа, 
чтобы ваш веб-сервер получил доступ на чтение этих каталогов, поскольку (по умолчанию) 
АрасЬе запускает ССІ-сценарии от имени такого пользователя: 

$ сИдгр -К ммм-сіа1:а /орі/діі 



После перезапуска АрасЬе вы должны получить возможность склонировать ваши репозитории 
из этого каталога указывая их в ІЛІЬ: 



$ діі сіопе М.ір : //діі . дИзегѵег/ргозесІ: . ді{ 




Таким образом, вы можете настроить доступ на чтение по НТТР к любому из ваших 
проектов для значительного количества пользователей за несколько минут. Другой простой 
способ дать открытый неаутентифицируемый доступ — использовать СіГ-демон, однако это 
требует запуска процесса демона. Мы рассмотрим этот вариант в следующем разделе, если 
вы предпочитаете этот вариант. 

4.6 Ск\ѴеЬ 

Теперь, когда у вас есть основной доступ на чтение и запись и доступ только на чтение к 
вашему проекту, вероятно, вы захотите настроить простой веб-визуализатор. СіІ поставляется 
в комплекте с ССІ-сценарием, называющимся СіГ\ѴеЪ, который обычно используется для этого. 
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Зсоіі СЬасоп Рго Сіі 



Раздел 4.6 Оіі\ѴеЬ 



/риЬ/зсгл / діѴдіІ.діІ / зиттагу 




«і* | 











смгю- Лхіо С на-плпо 



23 Поыгз шдо Дло С Нлтлпо М*гд* Ьгалеп теки 1 тмит 

ЛПОцгеаро ШпЛвиМэу Им Имйр тммоа оггмп ЮеИІпд ІЬ* іпйм (»»«. г-»* 

34 Поиг* М0О ШЮмы Моу Ооситат д<1 Ыапм -гтгм. 

34 йокг» «90 Шюшіи Саіу діімав: І%рММ тшШрЦ д» Ш/Ш оп №• мпм ИМИ - 

34Поиплдо ЛУдолм МММ *у«««і рвВД: ИтрШу иаіпд цгір рмя аиЛІхО, ... 

МЮѵПарО .АУіаѵт*» МММ МтосЬм М »ипе«оп аіпр р*№ аи«і*0 



гОёу$*до 


Длю С Нетто 


□оситѵпіаііо 
Мв»д* Ьгалеп 


п: Но» СИ ІогтИв ипс)-«таіі іесцгіа 

МИ 






ЛгноСнлтлпо 


ІМЫ: Па *Шр 


огі ѵагвѵаГ 








ІІК*-Ог»пСП -4: ЕірОІ СГТ ОІВ МГІЬИ 




гааувшдо 




іімііож ргоѵИ-пд тиіпрів щміімкі ЬгапсГма Ю гвЬм* 








Зкір |1т«а:«т 


р оГ'е'рпсгч Іог <*Л - ■ по-іпгіе і 








діі »ѵп: ііі раі 


•*1гѵд оі Отс«іатр оЫатсО Ігот іѵп 




гоаузадо 
20*узадо 


МкКИСку 
ОвтіРщж 




ттд* й.ги оѵагПоа рагтіПМ М ПО ... 
пфіі-риаЬ: -а II, -тіггс*. -іада сап ... 
оп: оп»у аЬоѵ 'Іод -те где' И тегдтд 





Рисунок 4.1: Веб-интерфейс Ск\ѴеЪ. 



Вы можете увидеть Сіі\ѴеЬ в действии на таких сайтах как Ііг.г.р : //діг. . кег пеі . огд (рис. 
4-1). 

Если вы хотите проверить, как СіІ\ѴеЬ будет выглядеть для вашего проекта, Сіі поставляется 
с командой для быстрой установки временного экземпляра, если в вашей системе есть легковесный 
веб-сервер, такой как ІІдНі: г.рсІ или иеЬгіск. На машинах с Ілгшх ІІдНг. X. рсі часто установлен, 
поэтому возможно вы сможете его запустить, выполнив діі. ІП5І:аиеЬ в каталоге с вашим 
проектом. Если вы используете Мае, Ьеорагсі поставляется с предустановленным КлЪу, поэтому 
иеЬгіск может быть лучшим выбором. Чтобы запустить ІП5І:аиеЬ с не Ііёііра, вы можете 
запустить команду с параметром - -ИИрсІ. 



$ діі іпз1:амеЬ - -Н(:(:рсІ=меЬгіск 
[2ѲѲ9-02-21 10:02:21] ІШРО ЫЕВгІск 1.3.1 

[2009-02-21 10:02:21] ІШРО гиЬу 1.8.6 (2008-03-03) [ипіѵегзаІ-сіагиіпЭ . 0] 



Это запустит сервер НТТРБ на порту 1234 и затем запустит веб-браузер, открытый на 
этой странице. Это очень просто. Когда вы закончили и хотите остановить сервер, вы можете 
запустить ту же команду с параметром - - 5Іор: 



$ д±1 іпз1:аиеЬ - -Н(:(:рсІ=иеЬгіск --зіор 



Если вы хотите иметь постоянно работающий веб-интерфейс на сервере для вашей команды 
или для проекта с открытым кодом на хостинге, вам необходимо установить ССІ-сценарий на 
вашем веб-сервере. В некоторых дистрибутивах Ьігшх есть пакет ді1:иеЬ, который вы можете 
установить, используя арі: или уит, так что вы можете попробовать сначала этот способ. 
Мы рассмотрим установку СіІ\ѴеЬ вручную очень вкратце. Для начала вам нужно получить 
исходный код Сіі, с которым поставляется СіІ\ѴеЬ, и сгенерировать ССІ-сценарий под свою 
систему: 



$ діі сіопе дИ : //діі . кегпеі . огд/риЬ/зст/дИ/дИ . д±1 
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$ ссі діС/ 

$ таке ОІТМЕВ.РКС^ЕСТРіООТ^Ѵорі/діи 1 ' \ 

рге1"іх=/изг ді1:іл/еЬ/ді1:ыеЬ . сді 
$ зисіо ср -Кг дііиеЬ /ѵаг/иии/ 

Помните, что вы должны указать команде, где расположены ваши репозитории СіІ с помощью 
переменной СІТІ\/ЕВ_РРСиЕСТРООТ. Теперь вы должны настроить АрасЬе на использование 
этого сценария, для чего вы можете добавить виртуальный хост: 

<Ѵігіиа1Н05І: *:8Ѳ> 

ЗегѵегМаше дііізегѵег 
Роситеп1:Коо1: /ѵаг/иии/ді1:иеЬ 
<0ігес1:огу /ѵаг/иии/ді1:иеЬ> 

ОрЧопз ЕхесССІ +Ро11ои5утІ.іпкз +5утІ_іпкзІ'Г0ипегМа1:сН 

АИоиОѵеггійе АН 

огсіег аііои, сіепу 

АІІои ■Ггот аіі 

АсісІНапсІІег сді-зсгірі: сді 

0ігес1:огуіпсіех діШеЬ.сді 
</0ігес1:огу> 
</Ѵіг(:иа1Ноз1:> 

Повторюсь, СііѴ/еЬ может быть установлен на любой веб-сервер, совместимый с ССІ. 
Если вы предпочитаете использовать что-то другое, настройка не должна стать для вас проблемой. 
К этому моменту вы должны иметь возможность зайти на ИПр : / / дііізегѵег/ для просмотра 
ваших репозиториев онлайн, а также использовать : / / діі. . діі. зе г ѵе г для клонирования 
и извлечения данных для ваших репозиториев по НТТР. 

4.7 СІІ05І5 

Хранение открытых ключей всех пользователей ваиІіНогігесІ^кеуз для предоставления 
доступа работает хорошо лишь на время. Когда у вас сотни пользователей, это скорее похоже 
на пытку. Вы должны заходить на сервер каждый раз, и нет никакого разграничения доступа 
— все перечисленные в файле имеют доступ на чтение и на запись к каждому проекту. 

На этой стадии вы можете захотеть обратиться к широко используемому ПО под названием 
СІЮ5І5. СІЮ5І5 — это просто набор сценариев (скриптов), который поможет вам управляться с 
файлом аи1:ИогІ2есІ_кеу5 и реализовать простой контроль доступа. Действительно интересно, 
что добавление людей и настройка доступа для них осуществляется не через веб-интерфейс, 
а с помощью специального §іІ-репозитория. Вы настраиваете информацию в этом проекте и, 
когда вы отправляете её в репозиторий, Сііобіб, исходя из неё, перенастраивает сервер, что 
круто. 

Установка Сііобіб — не самая простая задача, хотя и не слишком сложная. Проще всего 
использовать под него Ілпих-сервер — в наших примерах используется сервер ЦЬшіШ 8.10 в 
начальной конфигурации. 

СіЮ5І5'у нужны некоторые инструменты для Рушоп, так что первым делом вы должны 
установить пакет Рушоп'а зегиріооіз, который в ЦЬшіШ называется рутоп-вешріооІБ: 
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Зсой; СЬасоп Рго Сіі 

$ арі-деі: Іпз1:а11 руЬМоп-зе1:іір1:оо1з 



Раздел 4.7 Сііозіз 



Затем вы клонируете и устанавливаете СІЮ5І5 с главного сайта проекта: 

$ діі сіопе ді(:://еадаіп.пе(:/ді1:о5І5.ді(: 
$ ссі дііозіз 

$ зисіо ру1:Ноп зеіир.ру Іпз1:а11 



Это установит несколько исполняемых файлов, которые Сііобіб будет использовать. Затем 
СІЮ5І5 хочет расположить свои репозитории в каталоге /Ноте/діі:, что неплохо. Но вы 
уже установили репозитории в / орі:/ діі, так что вместо перенастройки всего на свете вы 
сделаете символическую ссылку: 

$ 1п -з /орі/діі /Ноте/дііі/герозііогіез 



СІЮ5І5 будет управлять ключами за вас, так что вы должны удалить текущий файл, добавить 
ключи снова позже и предоставить Сіі05І5'у управлять файлом аи 1: И о г І2есІ_кеу 5 автоматически. 
Сейчас просто уберите этот файл с дороги: 

$ тѵ /Иоте/ді1:/ . ззІі/аи1:Иогі2есІ_кеуз /Иоте/діі/ . ззИ/ак . Ьак 



Затем вы должны вернуть пользователю §іг его командную оболочку, если вы меняли её 
на команду дІЪ-ЗІІбІІ. Люди всё так же не смогут выполнить вход, но для вас это будет 
контролировать Сііовів. Итак, давайте поменяем эту строку в файле 7еіс/ра55\ѵа' 



діИ 


: х : 1000 : 1000 : : /Моте/діі: 


: /изг/Ьіп/ді1:-зИе11 


обратно на эту: 




: х : 1000 : 1000 : : /Иоте/ді1: 


: /Ьіп/зН 



Теперь самое время инициализировать Сііовіз. Сделаете это, выполнив команду діі 05 І5 - 
ІПІ1: со своим персональным открытым ключом. Если вашего открытого ключа ещё нет на 
сервере, вам нужно будет скопировать его туда: 



$ зисіо -Н -и діі дііозіз-іпіі: < /ітр/ісІ_сіза. риЬ 

Іпііііаіігесі етр1:у Сіі герозііогу іп /ор1:/ді1:/ді(:озіз-асітіп . діі/ 

Кеіпіііаіігесі ехізііпд бИ герозііогу іп /ор1:/ді1:/ді1:озіз-асІтіп . діЬ/ 
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Это позволит пользователю с таким ключом изменять главный СіГ-репозиторий, который 
управляет настройками СіГ05І5'а. Затем вы должны вручную установить бит исполнения на 
сценарий розі: - ирсіаііе в новом управляющем репозитории. 

$ зисіо сптосі 755 /орі/ді1:/ді1:озіз-ас1тіп . дііі/поокз/розіі-іірсіаіе 



Всё готово. Если вы всё настроили правильно, вы можете попытаться соединиться по 55Н 
с вашим сервером под тем пользователем, для которого вы добавили открытый ключ, чтобы 
инициализировать Сііобіб. Вы должны увидеть что-то вроде этого: 

$ ззп ді1:@ді1:зегѵег 

РТУ а11оса1:іоп гедиезі ■раііесі оп спаппеі 0 

•Гаіаі: ипгесодпігесі сотшапсі 'діііозіз-зегѵе зспасоп@диа1:егпіоп 1 
СоппесПоп Іо діізегѵег сіозесі. 



Это означает, что Сіговіз узнал вас, но не пустил, потому что вы не пытались выполнить 
ни одну из команд СіГ. Ну так давайте выполним настоящую команду СіГ — вы склонируете 
управляющий репозиторий Сіюбіб: 

# на вашем локальном компьютере 

$ діі сіопе ді1:§ді(:зегѵег : дііозіз-асітіп . діі 



Теперь у вас есть каталог с именем діііозіз - асішіп, в котором есть две главные части: 

$ ссі дііозіз-асітіп 
$ -ГіпсІ . 
. /дііозіз . соп^ 
. /кеусііг 

. /кеусІіг/зсо1:1: . риЬ 




Файл діііозіз . соггГ — файл настройки, который используется, чтобы указать пользователей, 
репозитории и права доступа. В каталоге кеусііг должны храниться открытые ключи всех 
пользователей, у которых есть какой-либо доступ к вашим репозиториям — по файлу на пользователя. 
Имя файла в кеусііг (в предыдущем примере ЗСОІІ; . риЬ) у вас будет отличаться — Сіюзіз 
берёт это имя из описания в конце открытого ключа, который был импортирован сценарием 
діЪозіз-іпіІ:. 

Если вы посмотрите в файл діііозіз . согтР, там должна быть указана только информация 
о проекте діііозіз - асітіп, который вы только что склонировали: 

$ саі ді1:озіз . соітГ 
[дИозіз] 
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5соП СЬасоп Рго Сіі 



Раздел 4.7 Сііозіз 



[дгоир діііозіз-асітіп] 
мгііаЫе = дИозіз-асІтіп 
тетЬегз = зсоЫ: 



Это показывает, что пользователь '5СОП' — пользователь, чьим открытым ключом вы 
инициализировали Сііобіб — единственный, кто имеет доступ к проекту діііозіз - асішіп. 

А теперь давайте добавим новый проект. Добавьте новую секцию с названием тоЬІІе и 
перечислите в ней всех разработчиков из команды, занимающейся мобильными устройствами, 
а также проекты, к которым этим разработчикам нужно иметь доступ. Поскольку 5 со 1:1: 
— пока что единственный пользователь в системе, добавьте его как единственного члена и 
создайте новый проект под названием іргіопе_рг О] есі:, чтобы ему было с чем начать работать: 

[дгоир тоЫІе] 

мгіІаЫе = ірНопе_ргс^ес1: 

тетЬегз = зсоЫ; 



Когда вы вносите изменения в проект діі. 05 І5 - асішіп, вы должны зафиксировать изменения 
и отправить их на сервер, чтобы они возымели эффект: 

$ діі соттіі: -ат 'асісі ірНопе_ргс^ес1: апб тоЫІе дгоир' 
[тазіег] : сгеа1:есі 8962сіа8: "сЬапдесІ пате" 
1 ■рііез спапдесі, 4 іпзег1:іопз( + ) , Ѳ сІе1еІіоп5( - ) 
$ діі ризИ 

СоипЫпд о^ес^в: 5, сіопе. 
Сотргеззіпд оЬ}'ес1:з: 100% (2/2), сіопе. 
ЫгіСіпд оЬзесИз: 100% (3/3), 272 ЬуНез, аопе. 
Тоіаі 3 (аеІИа 1), геизеа 0 (аеііа 0) 
То діі§ді1:зегѵег : /оріі/дііі/дііозіз-асітіп . діі 
1=Ь27аес. .8962сіа8 тазГег -> тазіег 



Вы можете сделать свой первый ризЬ в новый проект іргіопе_ргоз есі:, добавив свой 
сервер в качестве удалённого (гетоіе) в локальную версию проекта и выполнив діі риз И. 
Вам больше не нужно вручную создавать голые репозитории на сервере для новых проектов 
— СІЮ5І5 создаёт их сам автоматически, когда видит первый ривЬ: 

$ діі гетоііе асісі огідіп ді1:іді1:зегѵег : ірИопе_ргозесІ: . діі 
$ діі ризИ огідіп тазіег 

Іпіііаіііесі етрііу Сіі герозііюгу іп /ор1:/ді1:/ірІіопе_рго]ес(: . діі./ 
СоипЫпд оЬэесІіз: 3, сіопе. 

ЫгіИіпд оЬзесИз: 100% (3/3), 230 ЬуНез, аопе. 
Тоіаі 3 (аеІИа 0), геизеа 0 (аеііа 0) 
То діі§ді1:зегѵег : ірпопе_рго}ес1: . діі 
* [пем ЬгапсН] таз1:ег -> тазіег 



Заметьте, что вам не нужно указывать путь (фактически, если вы это сделаете, то оно не 
сработает), только двоеточие и имя проекта — Сііобіб найдёт его за вас. 
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Вы хотите работать над проектом с вашими друзьями, так что вам нужно снова добавить 
их открытые ключи. Но вместо того, чтобы вручную добавлять их к файлу ~/ . 55 И/ аи1:ИогІ2есІ_кеу5 
на вашем сервере, добавьте их, один файл на ключ, в каталог кеусІІГ . Как вы назовёте ключи 
определит как вы будете ссылаться на пользователей в ді1:05І5 . соп1\ Давайте по-новому 
добавим открытые ключи для Джона, Джози и Джессики: 

$ ср /Ітр/іс1_гза.]0Ііп.риЬ кеусІіг^оНп . риЬ 

$ ср /Ітр/ісІ_гзаоо5іе.риЬ кеусііг/^озіе . риЬ 

$ ср /Ітр/ісі_гза.]е53іса.риЬ кеусііг/зеззіса. риЬ 



Теперь вы можете добавить их всех в вашу 'мобильную' команду, чтобы они имели доступ 
на чтение и запись в іргіопе_ргоз есі;: 



[дгоир тоЫІе] 

игі1:аЫе = ірНопе_ргозес1: 

тетЬегз = зсоЫ: ]оИп зозіе зеззіса 




После того, как вы зафиксируете и отправите изменения, все четыре пользователя будут 
иметь возможность читать и писать в проект. 

В СІЮ5І5 также есть простой контроль доступа. Если вы хотите, чтобы Джон имел только 
доступ на чтение к этому проекту, вы можете вместо этого сделать: 

[дгоир тоЫІе] 

мгіІаЫе = ірНопе_ргозес1: 

тетЬегз = зсоЫ: ]озіе зеззіса 



[дгоир тоЫ1е_го] 
геасіопіу = ірЬопе_ргозес1: 
тетЬегз = зоііп 




Теперь Джон может клонировать проект и получать обновления, но Сііобіб не позволит 
ему отправлять изменения обратно в проект. Вы можете создать таких групп сколько хотите, 
каждую содержащую разные проекты и пользователей. Вы также можете указать другую 
группу в качестве одного из пользователей (используя § как префикс), чтобы автоматически 
добавить всех её членов: 



[дгоир тоЬі1е_соттіі(:егз] 
тетЬегз = зсоЫ: ]озіе зеззіса 

[дгоир тоЫІе] 

мгіІаЫе = ірІіопе_ргоз'ес(: 

тетЬегз = §тоЬі1е_сотті1:1:егз 

[дгоир тоЫ1е_2] 

мгі1:аЫе = апо1:Ьег_ірЬопе_рго]ес(: 
тетЬегз = §тоЫ1е_сотті1:1:егз іоЪп 
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Если у вас возникли какие-то проблемы, полезным может быть добавить 1од1еѵе1=0ЕВІІС 
в секции [дііозіз]. Если вы потеряли доступ к отправке, отправив неверную конфигурацию, 
вы можете вручную поправить файл /Ноте/ діі/ . діііозіз . соггР на сервере — файл, из 
которого СІЮ5І5 читает свою информацию. Отправка в проект берёт файл діііозіз . согтР, 
который вы только что отправили, и помещает его туда. Если вы отредактируете этот файл 
вручную, он останется таким до следующей успешной отправки в проект діііозіз - асітіп. 

4.8 СкоШе 

Сіі начал становиться очень популярным в корпоративных средах, где обычно есть дополнительные 
требования в плане контроля доступа. СііоІіГе изначально был создан, чтобы посодействовать 
в выполнении таких требований. Но, как оказывается, он также полезен и в мире ореп аоигсе: 
проект Реаога управляет доступом к своим репозиториям пакетов с помощью §іГо1і1:е. А ведь 
этих репозиториев больше 10 ООО! По видимому, это самая большая установка §і(оШе где бы 
то ни было. 

Сііоіііе позволяет указать права доступа не только для репозиториев, но и для веток или 
имён меток внутри каждого репозитория. То есть вы можете указать, что определённые люди 
(или группы людей) могут отправлять (ризЬ) определённые «ссылки» (ветки или метки), а 
остальные нет. 

4.8.1 Установка 

Установить Сііоіііе очень просто, даже если вы не читали обширную документацию, которая 
идёт вместе с ним. Вам нужен аккаунт на каком-нибудь Шіх сервере; были протестированы 
различные Ьіпих-ы и Зоіагіз 10. Вам не нужен гооі-доступ, если регі и орепзвЬ-совместимый 
сервер уже настроены. Далее в примерах мы будем использовать аккаунт дііоіііе на хосте 
с именем дііізегѵег. 

СііоШе несколько необычен, по крайней мере, в сравнении с другим «серверным» ПО 
— доступ осуществляется по ззЬ, и, следовательно, каждый пользователь на сервере является 
потенциальным «§іЮІі1:е-хостом». Поэтому всё выглядит как «установка» самого ПО и затем 
«настройка» пользователя как «§іЮІі1:е-хоста». 

СіГоШе может быть установлен четырьмя способами. Люди, использующие Реаога'у или 
БеЬіап, могут получить КРМ или БЕВ и установить его. Те, у кого есть гооі-доступ, могут 
сделать установку вручную. В обоих вариантах любой пользователь в системе затем может 
стать «§іЮІі1:е-хостом». 

Те, у кого нет гооі-доступа, могут установить его внутрь своих каталогов. И наконец, 
^іІоШе может быть установлен с помощью выполнения сценария на рабочей станции в Ъавп- 
шелле. (Если вам интересно, даже тот ЬавЬ, который идёт с т5у5§к, достаточен.) 

Последний способ мы опишем в этой статье; а остальные методы описаны в документации. 

Начните с настройки доступа к вашему серверу с помощью открытого ключа, так, чтобы 
вы могли войти с вашей рабочей станции на сервер без ввода пароля. Следующий способ 
работает в Ьіпих; для рабочих станций с другими ОС вам, возможно, нужно будет сделать это 
вручную. Мы полагаем, что у вас уже есть пара ключей сгенерированных с помощью 5 5 И - 
кеудеп. 
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Эта команда спросит у вас пароль к учётной записи '§іІоШ:е', а затем настроит доступ по 
открытому ключу. Он необходим для сценария установки, так что убедитесь, что вы можете 
выполнять команды без ввода пароля: 

$ ззИ ді1:о1і1:е§ді1:зегѵег рмсі 
/Иоте/ді1:о1і1:е 

Затем склонируйте Сішіііе с главного сайта проекта и выполните сценарий для лёгкой 
установки (третий аргумент это ваше имя в том виде, в котором вам бы хотелось его видеть в 
окончательном репозитории §ію1іі:е-аатіп): 

$ діі сіопе діі : //дііИиЬ . сот/зііагатс/діііоііііе 
$ ссі дііо1і1:е/згс 

$ . /дІ-еазу-іпзЬаІІ -р діСоІлЛе діізегѵег зНагат 

Всё готово! Сііоііге теперь установлен на сервере, и у вас в домашнем каталоге на рабочей 
станции теперь есть новый репозиторий, который называется дііоіііе - асішіп. Администрирование 
вашего установленного §іЮІіІе осуществляется с помощью внесения изменений в этот репозиторий 
и их отправки (ривп). 

Та последняя команда выводит довольно большое количество информации, которую может 
быть интересно прочитать. Также при первом её выполнении создаётся новая пара ключей; 
вам придётся выбрать пароль или нажать епіег, чтобы пароля не было. Зачем нужна вторая 
пара ключей и как она используется, описано в документе «ввЬ ГгоиЫезЬоойп§», поставляемом 
с Сііоіііе. (Ну должна же документация быть хоть для чего-то хороша!) 

По умолчанию на сервере создаются репозитории с именами ді1:о1і1:е-асІтіпи1:е5І:- 
іпд. Если вы хотите получить локальную копию какого-то из них, наберите (под учётной 
записью, которая имеет консольный 55Н-доступ к §іЮІі1:е-аккаунту в аиіНогіге^кеуз): 

$ діі сіопе дііоіііе : ді1:о1і1:е-асітіп 
$ діі сіопе діііоіііе : іез1:іпд 



Чтобы склонировать эти же самые репозитории под любым другим аккаунтом: 

$ діі сіопе ді1:о1і(:е§зегѵегпате : дііо1і1:е-асІтіп 
$ діі сіопе ді1:о1і(:е§зегѵегпате : іез1:іпд 
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4.8.2 Изменение параметров установки 

Хотя быстрая установка с параметрами по умолчанию подходит для большинства людей, 
есть несколько способов изменения параметров установки если вам это нужно. Если опустить 
опцию - д, вы получите «подробную» установку с детальной информацией о том, что происходит 
на каждом шаге. Подробный режим также позволяет изменить некоторые параметры на стороне 
сервера, такие как расположение репозиториев, с помощью редактирования «гс» файла, используемого 
сервером. Этот «гс» файл содержит развёрнутые комментарии так, чтобы вы легко смогли 
сделать любые изменения, сохранить их и продолжить. Этот файл также содержит различные 
настройки, которые вы можете изменить, чтобы активировать или выключить некоторые «продвинутые» 
функции §ИоШе. 

4.8.3 Конфигурационный файл и правила контроля доступа 

Когда установка завершена, вы переходите в репозиторий дііоіііе- асішіп (он находится 
в вашем домашнем каталоге) и осматриваетесь, чтобы выяснить что же вы получили: 

$ ссі ~/ді1:о1і1:е-асІтіп/ 
$ 1з 

согтГ/ кеусііг/ 

$ ■ріпсі согтГ кеусііг -(:уре Т 

соп-Г/дііоІіІіе . соітГ 

кеусііг/зі1:агат . риЬ 

$ саі согтГ/дИоШе.согтГ 

#ді1:о1і(:е согтГ 

# ріеазе зее соітГ/ехатрІе . соггГ Тог сіеііаііз оп зупГах апсі -Геаіигез 

геро дііо1і1:е-асІтіп 

КЫ+ = зНагат 

геро (іезіііпд 

ВИ+ = @а11 



Заметьте, что «зкагат» (это последний аргумент при выполнении д1-еазу-ІП5І:а11 
ранее) имеет права на чтение и запись в репозиторий дііоіііе - асішіп, а также файл с 
открытым ключом с таким же именем. 

Синтаксис конфигурационного файла для §ко1і1:е подробно продокументирован в СОПгѴ 
ехашріе . сопг", так что мы рассмотрим здесь только основные моменты. 

Вы можете сгруппировать пользователей или репозиторий для удобства. Имена групп 
совсем как макросы; когда вы их определяете, даже неважно, определяют ли они проекты или 
пользователей; это различие делается, только когда вы используете «макрос». 



§055_героз = Ііпих регі гакисіо діі: діііоіііе 

ізесгеі_героз = -репезііга реаг 

@асІтіпз = зсоіі: # Асіатз, поі: СИасоп, зоггу : ) 

§іп1:егпз = азііок # деі іМе зреіііпд гідИІ; , Зсоіі! 

іепдіпеегз = зііагат сІіІЬегі маііу аіісе 

ізІіа^Г^ = §асІтіпз іепдіпеегз @іп1:егпз 
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Вы можете контролировать права доступа на уровне «ссылок» (то, что находится в 
теѣ/). В следующем примере стажёры (группа (Эіпіегпв) могут отправлять (ривЬ) только ветку 
«іпі». Инженеры (группа @еп§іпеегв) могут отправлять любую ветку, чьё имя начинается с 
«еп§-», а также метки, начинающиеся с «гс» и затем содержащие цифры. Администраторы 
(группа (Эасітіпз) могут делать всё с любыми ссылками (в том числе откатывать назад). 



геро §озз_героз 




КЫ іпИ$ 


= §іпіегпз 


епд- 


= §епдіпеегз 


КИ гетз/1:адз/гс[0-9] 


= §епдіпеегз 


РѴѴ+ 


= §асітіпз 



Выражение после РМ или КѴ\/+ — это регулярное выражение (ге§ех), с которым сопоставляется 
имя отправляемой ссылки (геі). Поэтому мы называем его «ге&х»! Конечно, «гегех» может 
быть гораздо более сложным, чем показано здесь, так что не переусердствуйте с ними, если 
вы не очень хорошо знакомы с регулярными выражениями регі. 

К тому же, как вы уже, наверное, догадались, СіГоІіГе для удобства дописывает в начале 
регулярного выражения гег'з/Неайз/, если оно не начинается с геТз/. 

Важной особенностью синтаксиса конфигурационного файла является то, что все правила 
для репозитория не обязательно должны находиться в одном месте. Вы можете держать все 
общие вещи вместе, как, например, правила для всех 055_герс>5 выше, а потом добавить 
уточняющие правила для отдельных случаев следующим образом: 



геро дііоііііе 




РѴѴ+ 


= зНагат 



Это правило будет добавлено к набору правил для репозитория дііоіііе. 

В данный момент вы, возможно, задаётесь вопросом: «Каким образом правила контроля 
доступа применяются на самом деле?» — так что давайте вкратце рассмотрим это. 

В §іІо1іІе есть два уровня контроля доступа. Первый — на уровне репозитория; если у 
вас есть доступ на чтение (или запись) к любой ссылке в репозитории, то у вас есть доступ на 
чтение (или запись) к этому репозиторию. 

Второй уровень применим только к доступу на запись и осуществляется по веткам или 
меткам внутри репозитория. Имя пользователя, запрашиваемый уровень доступа (VI или +) 
и имя ссылки, которая будет обновлена, известны. Правила доступа проверяются в порядке 
их появления в конфигурационном файле, в поисках совпадений для этой комбинации (но 
помните, что имя ссылки сопоставляется с регулярным выражением, а не просто строкой). 
Если совпадение найдено, отправка (ривЬ) проходит успешно. При неудачном исходе доступ 
запрещается. 

4.8.4 Продвинутый контроль доступа с запрещающими правилами 

До сих пор у нас были только права вида Р, РМ, или Однако, в §іІо1іІе есть другие 

права доступа: - означающий «запретить». Это даёт гораздо больше возможностей взамен 
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большей сложности, так как теперь отсутствие разрешающего правила — не единственный 
способ получить запрет доступа, так что порядок правил теперь имеет значение*. 

Предположим, в описанной выше ситуации мы хотим, чтобы инженеры могли откатить 
назад любую ветку кроме тавіег и іпіе§. Вот как это сделать: 



РИ таз1:ег 


іпііед 


= іепдіпеегз 


тазііег 


іп1:ед 


= іепдіпеегз 


РѴѴ+ 




= іепдіпеегз 



Снова, вы просто идёте по правилам сверху вниз, пока не наткнётесь на соответствующее 
вашему режиму доступа или на запрет. Неоткатывающий ризЬ в тавГег или іпГе§ разрешается 
первым правилом. Откатывающий ривЬ для этих ссылок не соответствует первому правилу, 
переходит ко второму и поэтому запрещается. Любой ривЬ (откатывающий или неоткатывающий) 
по ссылкам, отличным от тавіег и іпіе§, не совпадёт с первыми двумя правилами, а третье 
правило его разрешает. 

4.8.5 Ограничение ршЬ-ей на основе изменённых файлов 

Вдобавок к ограничению веток, в которые пользователю можно отправлять изменения, вы 
можете также ограничить файлы, которые он может трогать. Например, возможно, МакеШе 
(или какая-то другая программа) не предназначен для изменения кем угодно, так как многие 
вещи зависят от него или сломаются, если изменения не будут сделаны правильно. Вы можете 
сказать §іЮІіІе-у: 



геро Тоо 






РЫ : 


= §]ІІПІОГ_ 


сіеѵз §зепіог_сІеѵз 


РИ МАМЕ/ = 


= ізепіог. 


_с!еѵз 


МАМЕ/Макегііе 


= @Зііпіог_ 


_сіеѵз 


РЫ МАМЕ/ = 


= §]ІІПІОГ_ 


_с!еѵз 



Это мощное средство продокументировано в сопгѴехатрІе . соггГ. 

4.8.6 Персональные ветки 

С-ііоШе также имеет средство, которое называется «персональные ветки» (или даже «персональное 
пространство имён веток»), которое может быть весьма полезным в корпоративных средах. 

Очень часто обмен кодом в мире §ІІ происходит через запросы «пожалуйста, заберите 
(риіі)». В корпоративных средах, однако, неаутентифицированный доступ под строгим запретом, 
и рабочая станция разработчика не может выполнить аутентификацию. Так что вы вынуждены 
отправить (ризЬ) работу на центральный сервер и попросить кого-нибудь забрать (риіі) её оттуда. 

Это обычно вызывает такой же беспорядок с именами веток, что и в централизованных 
СУВ, плюс настройка прав доступа для этого становится ежедневной обязанностью админа. 

С-іІоШе позволяет определить «персональный» или «рабочий» префикс пространства имён 
для каждого разработчика (например, ге'Гз/рег 50па1/<сіеѵпате>/*); подробное описание 
есть в разделе «регзопаі ЬгапсЬев» в сіос/З-г^ - Іірз-еІС . шксі. 
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4.8.7 «Шаблонные» репозитории 

СіГоШе позволяет указывать репозитории с помощью шаблонов (на самом деле регулярных 
выражений регі), таких как, например, аз зідпшеп 1:з/5 [0-9] [0-9] /а [0-9] [0-9]. Это 
очень мощная функция, которая включается с помощью установки $С Ь_1л/І ЮРЕР05 = 1 ; в 
гс файле. Она позволяет назначать новый режим доступа («С»), который позволяет пользователям 
создавать репозитории на основе подобных шаблонов, автоматически назначает владельцем 
пользователя, который создал репозиторий, позволяет ему раздавать К и К\Ѵ права другим 
пользователям и т.п. Эта функция описана в документе сІос/4-іл/і1сІсагсІ-геро5І1:огіе5.тксІ. 

4.8.8 Другие функции 

Мы закончим это обсуждение рассмотрением подборки других функций, все они и многие 
другие описаны в мельчайших подробностях в документе «іж}5, гірз, еіс» и некоторых других. 

Логирование: Сііоііге регистрирует все успешные действия. Если вы несколько легкомысленно 
раздали людям права на откатывание изменений и кто-то снёс «такіег», лог-файл спасёт 

вам жизнь, и вы легко и быстро найдёте потерянный 5НА. 

Ск не в обычном РАТН: Одна крайне полезная и удобная функция в §іЮІі1:е — это поддержка 
§І1, установленного вне обычного $РАТН (это совсем не такая редкость, как вы думаете; в 
некоторых корпоративных средах или даже у некоторых хостинг-провайдеров запрещается 
устанавливать что-либо в систему, и всё заканчивается тем, что вы кладёте всё в свои личные 
каталоги). Обычно вы вынуждены каким-то образом заставить §ІГ на стороне клиента учитывать 
это нестандартное расположение бинарников §іі-а. С §і(оШе просто выберите «подробную» 
установку и задайте $6ІТ_РАТН в «гс» файлах. Никаких изменений на стороне клиента после 
этого не требуется. 

Уведомление о правах доступа: Другая удобная функция проявляется в момент, когда 
вы просто проверяете и заходите по квЬ на сервер. Сііоіііе показывает, к каким репозиториям 
у вас есть доступ и какого типа доступ может быть получен. Вот пример: 



Неііо зі1:агат, ІИе дИоІіЛе ѵегзіоп Неге із ѵ1.5.4-19-да3397сІ4 


іііе дИоІііе соігРід діѵез уои 1:Кіе -Гоііоиіпд ассезз: 


К 




апи-ызсі 


К 




епЬгапз 


К 


ы 


діі-поіез 


К 


и 


дііоііііе 


К 


и 


дііоііііе-асітіп 


К 




іпсІіс_иеЬ_іприІ: 


К 




зИгее1ірі_сопѵег1:ег 



Делегирование: При действительно больших установках вы можете делегировать ответственность 
за группы репозиториев различным людям, которые будут независимо управлять этими частями. 
Это уменьшает нагрузку на главного админа и делает его не таким критичным элементом. Эта 
функция описана в отдельном файле в каталоге сіос/. 

* Поддержка СішеЬ*: Сііоіііе имеет поддержку §іГѵѵеЪ в нескольких аспектах. Вы можете 
указать, какие репозитории видны через §ігѵѵеЬ. Вы можете назначить «владельца» и «описание» 
для §ігѵѵеЬ из конфигурационного файла для §і!о1і1:е. В §ігѵѵеЪ есть механизм организации 
контроля доступа через аутентификацию по НТТР, и вы можете заставить его использовать 
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«скомпилированный» конфигурационный файл, сделанный §ИоШе-ом, что означает действие 
одинаковых правил контроля доступа (для доступа на чтение) и для §ігѵѵеЪ, и для §і(о1іІе. 

Зеркалирование: СіЮІііе может помочь вам поддерживать несколько зеркал, и легко 
переключаться между ними, если основной сервер упадёт. 

4.9 Сіі-демон 

Для публичного неаутентифицированного доступа на чтение к вашим проектам вы можете 
захотеть продвинуться дальше, чем протокол НТТР, и начать использовать СіГ-протокол. Главная 
причина — скорость. Сіг-протокол гораздо эффективнее и поэтому быстрее чем НТТР, поэтому, 
используя его, вы можете сэкономить вашим пользователям время. 

Повторимся, это для доступа только на чтение без аутентификации. Если вы запустите 
его на сервере не за сетевым экраном, он должен использоваться только для проектов, которые 
публично видны внешнему миру. Если сервер, на котором вы его запускаете, находится за 
вашим сетевым экраном, вы можете использовать его для проектов, к которым большое число 
людей или компьютеров (серверов непрерывной интеграции или сборки) должно иметь доступ 
только на чтение, и если вы не хотите для каждого из них заводить 55Н-ключ. 

В любом случае, протокол СіГ относительно просто настроить. Упрощённо, вам нужно 
запустить следующую команду в демонизированной форме: 

діі сіаетоп - - геизеасісіг - -Ьазе-раіІі=/ор1:/ді1:/ /орі/діі/ 



--геизеасісіг позволит серверу перезапуститься без ожидания истечения старых подключений, 
- - Ьазе - ра1:И позволит людям не указывать полный путь, чтобы склонировать проект, а путь 
на конце говорит демону Сіг, где искать экспортируемые репозитории. Если у вас запущен 
сетевой экран, вы должны проколоть в нём дырочку, открыв порт 9418 на машине, на которой 
это всё запущено. 

Вы можете демонизировать этот процесс несколькими путями, в зависимости от операционной 
системы. На машине с ЦЬшіШ используйте ІірзіагГ-сценарий. Итак, в этом файле 

/еіс/еѵепі: . аѴІосаІ-діі-сіаетоп 



поместите такой сценарий: 

зЬагІ: оп зГагГир 
зіор оп зпиМомп 
ехес /изг/Ьіп/діІ: сіаетоп \ 

--изег=ді1: --дгоир=ді1: \ 

- - геизеасісіг \ 

- -Ьазе-ра1:п=/ор(:/ді1:/ \ 

/орі/діИ/ 
гезраып 
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По соображениям безопасности крайне приветствуется, если вы будете запускать этого 
демона как пользователя с правами только на чтение на репозитории — вы легко можете сделать 
это, создав пользователя '§іІ-го' и запустив этого демона из-под него. Для простоты мы запустим 
его от того же пользователя от которого запущен Сііобіб. 

Когда вы перезапустите машину, СіГ -демон запустится автоматически, и возродится, если 
вдруг завершится. Чтобы запустить его без перезагрузки машины, выполните следующее: 

іпіісіі зіагі: 1оса1-ді1:-с1аетоп 



На других системах вы можете использовать х і п е 1: сі , сценарий вашей системы зузѵіпіі:, 
или что-то другое — главное, чтобы вы могли эту команду как-либо демонизировать и перезапускать 
в случае завершения. 

Затем, вы должны указать Сігозіз-серверу к каким репозиториям предоставить неаутентифицированный 
доступ через Сіі-сервер. Если вы добавили по секции для каждого репозитория, вы можете 
указать, из каких из них СіГ-демону позволено читать. Если вы хотите предоставить доступ 
через Сіг-протокол к вашему проекту ірЬопе, добавьте это в конец вашего файла діііозіг.сопг': 

[геро ірИопе_рго]ес(:] 
сіаетоп = уез 



Когда это зафиксировано и отправлено, ваш запущенный демон должен начать обслуживать 
запросы к проекту от всех, у кого есть доступ к порту 9418 на вашем сервере. 

Если вы решили не использовать Сііовіз, но хотите установить СК-демон, вы должны 
выполнить следующее в каждом проекте, который должен обслуживаться СіГ-демоном: 

$ ссі /ра1:И/1:о/рго]ес(: .діі: 
$ ЬоисМ ді1:-сІаетоп-ехрог1:-ок 



Наличие этого файла скажет Сі('у, что можно обслуживать этот проект без аутентификации. 
СІЮ5І5 также может контролировать, какие проекты будет показывать СігѴѴеЪ. Вам нужно 
добавить что-то вроде этого в файл /е1:с/ді1:иеЬ . сопг": 

$рго]есіз_1і5І: = "/Иоте/ді1:/ді1:озіз/ргозес1:з . 1із1:" ; 
$рго]есігоо1: = "/Иоте/дііі/герозііогіез" ; 
$ехрогі_ок = "діі-сіаетоп-ехрогіі-ок"; 
ідіІ_Ьазе_иг1_1із1: = ( 1 діі : //дііізегѵег ' ) ; 



Вы можете контролировать, какие проекты СііѴѴеЪ будет позволять просматривать пользователям, 
добавляя или удаляя пункт настройки дІ1:иеЬ в конфигурационном файле Сііобіб. Например, 
если вы хотите, чтобы ваш проект ірЬопе просматривался в СіГ\ѴеЪ, сделайте, чтобы секция 
настроек геро выглядела следующим образом: 
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[геро ірИопе_рго]ес(:] 
сіаетоп = уез 
діГиеЬ = уез 

Теперь, если вы зафиксируете и отправите изменения, СііЛѴеЪ автоматически начнёт показывать 
ваш проект ірЬопе. 

4.10 Сіі-хостинг 

Если вы не хотите связываться со всей работой по установке собственного Сіі-сервера, 
у вас есть несколько вариантов размещения ваших Сіі-проектов на внешних специальных 
хостинг сайтах. Это предоставляет множество преимуществ: на хостинг сайте обычно быстро 
настроить и запустить проект и нет никакого мониторинга или поддержки сервера. Даже 
если вы установили и запустили свой собственный внутренний сервер, вы можете захотеть 
использовать публичный хостинг сайт для вашего открытого кода — обычно сообществу открытого 
кода так будет проще вас найти и помочь. 

В наши дни у вас есть огромное количество вариантов хостинга на выбор, все со своими 
преимуществами и недостатками. Чтобы увидеть актуальный список, проверьте страницу 
СіШо5йп§ в главной вики Сіі: 

ЬЫ.р : //діі. . ог . с2/ді1:ѵ\/ікі/6і1:Н05І:іпд 

Поскольку мы не можем рассмотреть их все, и поскольку я работаю на один из них, мы в 
этом разделе рассмотрим процесс создания учётной записи и нового проекта на СііНиЬ. Это 
даст вам представление о вовлечённых в него вещах. 

СіШиЬ — крупнейший на сегодняшний день сайт, предоставляющий Сіі-хостинг для 
проектов с открытым исходным кодом, а также один из немногих, предоставляющих одновременно 
и публичный, и приватный хостинг, так что вы можете хранить ваш открытый и коммерческий 
код в одном месте. На самом деле, мы использовали СіШиЬ, чтобы закрыто совместно писать 
эту книгу (прим. переводчика: и открыто переводить после её издания). 

4.10.1 СіШиЬ 

СіШиЬ немного отличается от других хостингов кода способом группировки проектов. 
Вместо того, чтобы брать за основу проекты, СііНиЬ ориентируется на пользователей. Это 
значит, что если я размещаю свой проект дгіі: на СіШиЬ, вы не найдёте его в діІіНиЬ . сот/ 
дгіг_, он будет в діг_гіиЬ . сот/зсИасоп/дгіІ:. Здесь нет никакой канонической версии 
проекта, что позволяет проектам беспрепятственно переходить от одного пользователя к другому, 
если начальный автор забросил проект. 

СіШиЬ — это коммерческая компания, которая взимает плату с учётных записей, использующих 
приватные репозитории, но любой может хоть сейчас получить бесплатную учётную запись и 
разместить сколько ему угодно открытых проектов. Мы быстро рассмотрим, как это делается. 

4.10.2 Настройка учётной записи 

Первое, что вам нужно сделать, это настроить учётную запись. Если вы посетите страницу 
Ріапв & Ргісіп§ по адресу гіг_1:р : //діг_гіиЬ . сот/ріапз и нажмёте на кнопку «Сгеаіе а (гее 
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ассошіі» (см. рисунок 4-2), вы попадёте на страницу регистрации. 




СЬоозе «Не ріап 1Ьа«'з гідМ Іог уои. 

Рта Цапа ап ММ пмл1Му алв сап м ЩЯЙМираМВВкИгі аі апу I"» «ОЮШ (М^ 



Ороп Зоигсв 
ргее! 

чышиа Риоас Парома*** 
ЦпІІгіІМ РиСАс ССМюгаЮп 
300 МВ Е>*к5ра» 



Рисунок 4.2: Страница тарифных планов СіШиЪ. 



Здесь вы должны выбрать имя пользователя, которое ещё не занято в системе, ввести 
адрес электронной почты, который будет сопоставлен аккаунту и пароль (см. рис. 4-3). 



5ідп ир 




Рисунок 4.3: Страница регистрации пользователя СііНиЬ. 



Если есть возможность, сейчас также самое время добавить свой открытый 55Н-ключ. 
Мы рассмотрели, как создать ключ, ранее, в разделе «Создание открытого 55Н-ключа». Возьмите 
содержимое открытого ключа из своей пары и вставьте в поле для ввода открытого 55Н-ключа. 
Ссылка «ехріаіп ббп кеув» направит вас к подробным инструкциям о том, как это сделать на 
всех основных операционных системах. Нажатие на кнопку «I а§гее, 5І§п те ир» откроет 
инструментальную панель вашего нового пользователя (см. рис. 4-4). 

еііЬиЬ ~~ &з """*"" 

ОюсИІСОМв П<тт Он» - 

Меѵ.'5 Реи. Ѵоиг Перозііогіез от) 

Гвг іітат — I риМс I рлтв I кипа I ЮЛ» 

І^МЯ Шш 3 МЛ ММ 



Рисунок 4.4: Инструментальная панель на СііНиЪ. 
После этого вы можете создать новый репозиторий. 
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4.10.3 Создание нового репозитория 

Начните с нажатия на «№\ѵ герозііогу» рядом с разделом «Ѵоиг Керовііогіев» на странице 
инструментальной панели. Вы попадёте к форме для создания нового репозитория (см. рис. 
4-5). 
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Рисунок 4.5: Создание нового репозитория на СііНиЪ. 

Единственное, что вам обязательно нужно сделать, это указать имя проекта, но вы также 
можете добавить и описание. Когда сделаете это, нажмите на кнопку «Сгеаіе Керо&іШгу». 
Теперь у вас есть новый репозиторий на СііНиЪ (см. рис. 4-6). 




Рисунок 4.6: Заглавная информация проекта СііНиЬ. 



Поскольку у вас ещё нет кода, СігНиЬ покажет вам инструкцию, как создать совершенно 
новый проект, отправить существующий или импортировать проект из публичного репозитория 
ЗиЬѵегйіоп (см. рис. 4-7). 
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ді( риіК огідіп тоііег 

Еківііпд СіІ Неро? 
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ди риіЬ огідіп тоЯег 

Ітрогііпд а 8ѴИ Неро? 



Ѵ/Ьеп уои'ге гіопе: 



Рисунок 4.7: Инструкции для нового репозитория. 



Эти инструкции похожи на то, что мы проходили раньше. Чтобы инициализировать проект, 
если это ещё не Сіі-проект, используйте: 
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$ діі іпіі: 
$ діі асісі . 

$ діі соттіі: -т 'іпі(:іа1 соттіі: 1 

Если у вас есть локальный С-іІ-репозиторий, добавьте С-іШиЪ как удалённый сервер и 
отправьте туда свою ветку тазіег: 

$ діі гетоГе асісі огідіп ді1:іді1:ИиЬ.сот:1:е5І:іпди5ег/ірИопе_ргозес1:.ді1: 
$ діі ризИ огідіп тазіег 

Теперь ваш проект размещён на С-іШиЪ, и вы можете дать ссылку на него любому, с кем 
вы захотите разделить проект. В этом случае, это ЬИр : //діСгіиЬ . сот/1:е5І:іпди5ег/ 
ірИопе_ргоз есС. Вы также можете видеть в заголовке каждой страницы проекта, что у вас 
две С-іІ-ссылки (см. рис. 4-8). 

іегііпдизег / ірИопе_ргоіес( ( . «и ) ( » штамп > 

Овзсгіріірп: ірГгапс ргсуссі (ог оиг тоЫІо дгаир ойіі 

Ноторадо СІІск (о вйіі схііі 

РиЫіс Скхіе ІІЧІ діі.//дііГіиЬ сотЛозітдизог/ірЬоло ргоіѳсі діі Щ 

Уоиг СІопе иРЬ діІ@д№иЬ.сопі:1в8(іпди5ѳг/ІрЬопе рго)ѳс(.ді) |г| 



Рисунок 4.8: Заголовок проекта с публичной и приватной ссылками. 

Ссылка «РиЫіс Сіопе ІЖЬ» — это публичная ссылка только для чтения, через которую 
кто угодно может склонировать проект. Можете опубликовать эту ссылку или разместить её 
на своём сайте — где угодно. 

«Уоиг Сіопе ІЖЬ» — это 55Н-ссылка на чтение и запись, через которую вы можете читать 
и писать только в том случае, если вы подключаетесь с использованием секретного ключа из 
пары открытого 55Н-ключа, загруженного в вашу учётную запись. Если другие пользователи 
посетят страницу этого проекта, они не увидят этой ссылки — только публичную. 

4.10.4 Импорт из 8иЬѵег8Іоп 

Если у вас есть существующий публичный ЗиЬѵегзіоп-проект, который вы хотите импортировать 
в Сй, СііНиЬ часто может сделать это за вас. Внизу страницы инструкций есть ссылка на 
импорт из ЗиЬѵегеіоп. Если вы кликнете по ней, вы увидите форму с информацией о процессе 
импорта и текстовое поле, где вы можете вставить ссылку на ваш публичный ЗиЬѵегвіоп-проект 
(см. рис. 4-9). 

Если ваш проект очень большой, нестандартный или приватный, этот процесс, возможно, 
не сработает для вас. В главе 7 вы узнаете, как делать более сложные импорты вручную. 

4.10.5 Добавление участников 

Давайте добавим остальную команду. Если Джон, Джози и Джессика зарегистрированы 
на СііНиЬ, и вы хотите дать им доступ на отправку изменений в свой репозиторий, вы можете 
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Рисунок 4.9: Интерфейс импорта из 8иЬѵегзюп. 

добавить их в свой проект как участников. Это позволит им отправлять изменения, используя 
свои открытые ключи. 

Нажмите на кнопку «еаіі» в заголовке проекта или вкладку «Аатіп» вверху, чтобы попасть 
на страницу администратора вашего проекта на СіШиЬ (см. рис. 4-10). 



Іебііпди&ѳг / ІрЬоп* рго)*с1 
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Рисунок 4.10: Страница администратора на СіШиЬ. 



Чтобы дать другому пользователю доступ на запись в проект, кликните по ссылке «Аасі ап- 
оіЬег соІІаЬогаІог». Появится новое текстовое поле, в котором вы можете набрать имя пользователя. 
По мере набора всплывёт подсказка, показывающая возможные совпадения имён. Когда найдёте 
нужного пользователя, нажмите на кнопку Айй, чтобы добавить пользователя как участника 
вашего проекта (см. рис. 4-11). 



Рсрозііогу СоІіаЬогаіогз 



Рисунок 4.11: Добавление участника в проект. 

Когда закончите добавлять участников, вы должны увидеть их список в разделе Керовііогу 
СоІІаЪогаІогз (см. рис. 4-12). 

Если вам нужно отозвать чей-то доступ, можете кликнуть по ссылке «геѵоке», и его доступ 
на отправку будет удалён. Для будущих проектов вы также можете скопировать группы участников, 
скопировав права доступа из существующего проекта. 
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Рисунок 4.12: Список участников вашего проекта. 



4.10.6 Ваш проект 

После того как вы отправили ваш проект или импортировали его из ЗиЪѵегеіоп, у вас есть 
главная страница проекта, которая выглядит как на рис. 4-13. 
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Рисунок 4.13: Главная страница проекта на СііНиЪ. 



Когда люди посещают ваш проект, они видят эту страницу. Она содержит вкладки, касающиеся 
различных аспектов вашего проекта. Вкладка Соттіів показывает список коммитов в обратном 
хронологическом порядке наподобие вывода команды діі Іод. Вкладка №гѵѵогк показывает 
всех людей, отделивших ваш проект и вернувших свои наработки. Вкладка Во\ѵп1оасІ5 позволяет 
выложить бинарные файлы проекта и ссылки на архивы каких-нибудь отмеченных точек проекта. 
Вкладка \Ѵікі предоставляет вики, где вы можете написать документацию или другую информацию 
о своём проекте. Вкладка СгарЬз показывает некоторую информацию о вкладе участников и 
статистику проекта. Главная вкладка Зоигсе показывает листинг корневого каталога проекта и 
автоматически выводит под ним содержимое файла КЕАБМЕ, если он у вас есть. Эта вкладка 
также показывает информацию о последнем коммите. 



4.10.7 Ответвления проектов 

Если вы хотите внести вклад в существующий проект, в который у вас нет права на отправку 
изменений, СіШиЬ приветствует ответвления. Когда вы смотрите на страницу заинтересовавшего 
вас проекта и хотите немного поработать над ним, вы можете нажать на кнопку «Гогк» в 
заголовке проекта, чтобы СіШиЬ скопировал проект вашему пользователю, и вы смогли отправлять 
туда свои изменения. 

Таким образом, проектам не нужно беспокоиться о добавлении пользователей в качестве 



108 



Зсоіі СЬасоп Рго Сіі 



Раздел 4.11 Итоги 



участников для предоставления им доступа на отправку изменений. Люди могут ответвить 
проект и отправлять изменения в свою копию. А мейнтейнер главного проекта может вернуть 
эти изменения, добавляя форки как удалённые серверы и сливая из них наработки. 

Чтобы ответвить проект, посетите страницу проекта (в нашем случае тортЪо/спготс) и 
нажмите на кнопку «Рогк» в его заголовке (см. рис. 4-14). 
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Рисунок 4.14: Получение доступной для записи копии любого репозитория. 

Через несколько секунд вы будете направлены на страницу своего нового проекта, на 
которой указано, что данный проект является ответвлением другого проекта (см. рис. 4-15). 

зсгіасоп / сМгопіс ( - «а» ) ( « итиюі > 

Рогк о/ то/отЬо/сЬгопй: 

Овзсгірііоп: СИгопіс із а риге РиЬу паіигаі Іапдиадс саіе рагзег. обіі 
Нотврадо: МПр.//сЬгопіс.гиЬуІогде.огд осііі 

РиЫісСІопе ЫШ: ді!://дівіиЬ.сот/зсЬасоп/сЬгопіс.діІ В 
Уоиг Сіопе ІІРІ.: діІ@дітиЬ сот зсЬасогѵсПготс діг \г} 

Рисунок 4.15: Вы ответвили проект. 



4.10.8 Заключение о СіШиЬ 

Это всё, что мы хотели бы рассказать про СіШиЬ, но важно отметить, как быстро вы 
можете всё сделать. Вы можете создать аккаунт, добавить новый проект и отправить изменения 
в него за минуты. Если ваш проект с открытым исходным кодом, вы также получите огромное 
сообщество разработчиков, которые смогут увидеть ваш проект, ответвить его и внести в него 
свой вклад. Во всяком случае, это хороший способ получить готовую к работе с Сіі среду, 
чтобы быстренько испытать его в деле. 



4.11 Итоги 

У вас есть несколько вариантов получения удалённого Сіі-репозитория так, чтобы вы 
могли принимать участие в проекте вместе с другими или поделиться работой. 

Запуск своего сервера даёт полный контроль и позволяет запускать сервер за вашим сетевым 
экраном, но такой сервер обычно требует значительной части вашего времени на настройку и 
поддержку. Если вы разместите ваши данные на хостинге, его просто настроить и поддерживать; 
однако вам необходимо иметь возможность хранить код на чужом сервере, а некоторые организации 
этого не позволяют. 

Выбор решения или комбинации решений, которые подойдут вам и вашей организации, 
не должен вызвать затруднений. 
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Теперь, когда вы обзавелись настроенным удалённым СіГ-репозиторием, являющимся местом, 
где разработчики могут обмениваться своим кодом, а также познакомились с основными командами 
СіІ'а для локальной работы, мы рассмотрим как задействовать некоторые распределённые 
рабочие процессы, предлагаемые Сіі'ом. 

В этой главе мы рассмотрим работу с СіГ'ом в распределённой среде как в роли рядового 
разработчика, так и в роли системного интегратора. То есть вы научитесь успешно вносить 
свой код в проект, делая это как можно более просто и для вас, и для владельца проекта, а 
также научитесь тому, как сопровождать проекты, в работе над которыми участвует множество 
человек. 

5.1 Распределённые рабочие процессы 

В отличие от централизованных систем управления версиями, распределённая природа 
СіІ'а позволяет вам быть гораздо более гибким в отношении участия разработчиков в работе 
над проектами. В централизованных системах все разработчики являются узлами сети, более 
или менее одинаково работающими на центральном хабе. Однако, в СіГ каждый разработчик 
потенциально является и узлом, и хабом. То есть каждый разработчик может как вносить код 
в другие репозитории, так и содержать публичный репозиторий, на основе которого работают 
другие разработчики, и в который они вносят свои изменения. Это даёт вашей команде возможность 
осуществлять любой из множества различных способов осуществления рабочего процесса в 
ваших проектах, поэтому мы рассмотрим несколько распространённых подходов, пользующихся 
гибкостью СіГ'а. Мы рассмотрим сильные стороны и возможные недостатки каждого подхода; 
вы можете выбрать для себя один из них, а можете совместить особенности сразу нескольких 
подходов. 

5.1.1 Централизованный рабочий процесс 

В централизованных системах существует, как правило, одна модель совместной разработки 
— централизованный рабочий процесс. Один центральный хаб, или репозиторий, может принимать 
код, а все остальные синхронизируют свою работу с ним. Некоторое число разработчиков 
являются узлами — клиентами этого хаба — и синхронизируются с ним одним (смотри Рисунок 
5-1). 

Это значит, что если два разработчика выполняют клонирование с хаба, и оба делают 
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Рисунок 5.1: Централизованный рабочий процесс. 



изменения в проекте, то первый из них, кто отправит свои изменения обратно на хаб, сделает 
это без проблем. Второй разработчик должен взять наработки первого и выполнить слияние 
перед тем, как отправить свои изменения, так чтобы не перезаписать изменения первого разработчика. 
Этот принцип справедлив для Сіі точно также, как и для ЗиЬѵегвіоп (или любой другой ЦСУВ), 
и в СіІ такая модель работает отлично. 

Если у вас небольшая команда или вас полностью устраивает рабочий процесс централизованного 
типа, применяемый в вашей компании, вы можете просто продолжить использовать такой 
рабочий процесс и в Сй. Просто настройте один репозиторий и дайте каждому в вашей команде 
права на отправку изменений; СіІ не позволит пользователям перезаписывать наработки друг- 
друга. Если какой-то разработчик склонирует репозиторий, сделает в нём изменения, а затем 
попытается выложить эти изменения, в то время как другой разработчик уже успел отправить 
свои, сервер отклонит изменения этого разработчика. Ему будет сказано, что он пытается 
выложить изменения, для которых невозможно выполнить перемотку (пізі-^огѵѵага), и что надо 
сначала извлечь данные с сервера, выполнить слияние, а уже потом отправлять свои изменения. 
Такой рабочий процесс привлекателен для большого количества людей, так как это та модель, 
с которой многие знакомы, и которая многим понятна. 



5.1.2 Рабочий процесс с менеджером по интеграции 

Так как Сіі позволяет иметь несколько удалённых репозиториев, существует возможность 
ведения такого рабочего процесса, при котором каждый разработчик имеет права на запись 
в свой собственный публичный репозиторий и права на чтение для всех остальных. Этот 
сценарий часто подразумевает существование канонического репозитория, который представляет 
собой «официальный» проект. Чтобы принять участие в работе над этим проектом, надо 
создать свою собственную публичную копию проекта и выложить туда свои изменения. Потом 
вы можете отправить запрос владельцу основного проекта на внесение в него ваших изменений. 
Он может добавить ваш репозиторий в качестве удалённого, протестировать локально ваши 
изменения, слить их со своей веткой и затем отправить обратно в публичный репозиторий. 
Этот процесс осуществляется следующим образом (смотри Рисунок 5-2): 



1. Владелец проекта выкладывает файлы в публичный репозиторий . 



2. Участники проекта клонируют этот репозиторий и делают изменения. 
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3. Участники выкладывают изменения в свои собственные публичные репозитории. 



4. Участник проекта отправляет владельцу письмо с просьбой включения его изменений. 



5. Владелец проекта добавляет репозиторий участника как удалённый и локально выполняет слияние. 



6. Владелец отправляет слитые изменения в основной репозиторий. 




Рисунок 5.2: Рабочий процесс с менеджером по интеграции. 



Это очень распространённый тип рабочего процесса для сайтов вроде СііНиЪ, где можно 
легко форкнуть проект и выложить свои изменения на всеобщее обозрение в собственную 
копию. Одно из главных преимуществ такого подхода — возможность продолжать работать, 
в то время, как владелец основного репозитория может включить себе ваши изменения, когда 
ему угодно. Участникам проекта не придётся ждать, пока их изменения не будут включены в 
проект — каждый может работать в своём собственном ритме. 



5.1.3 Рабочий процесс с диктатором и его помощниками 

Это одна из разновидностей рабочего процесса с множеством репозиториев. В основном 
он используется в огромных проектах с сотнями участников; ядро Ыпих яркий тому пример. 
Несколько менеджеров по интеграции заведуют разными частями репозитория; этих людей 
называют помощниками. У всех этих помощников есть только один менеджер по интеграции, 
которого называют благосклонным диктатором. Репозиторий благосклонного диктатора служит 
эталонным репозиторием, откуда все участники проекта должны брать изменения. Этот процесс 
происходит так (смотри Рисунок 5-3): 



1. Обычные разработчики работают над своими тематическими ветками и перемещают свою работу на вершину ветк 



2. Помощники сливают тематические ветки разработчиков в свои ветки шазіег. 



3. Диктатор выполняет слияние веток тазт_ег своих помощников со своей веткой тазг_ег. 
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4. Диктатор отправляет свою ветку тазіег в эталонный репозиторий, чтобы остальные разработчики могли выпог 




Рисунок 5.3: Рабочий процесс с благосклонным диктатором. 



Этот тип рабочего процесса не является распространённым, но он может быть полезен в 
очень больших проектах или в сильно иерархическом окружении, так как он позволяет лидеру 
проекта (диктатору) передать другим полномочия по выполнению большой части работ и собирать 
код большими порциями с нескольких мест перед его интеграцией. 

Мы рассмотрели несколько широко используемых типов рабочих процессов доступных 
при работе с распределёнными системами вроде Сіі, но, как видите, возможны различные 
вариации для подгонки под ваш конкретный тип рабочего процесса. Теперь, когда вы в состоянии 
определить, какая комбинация рабочих процессов сработает для вас лучше, мы рассмотрим 
несколько более специфичных примеров действий, выполняемых основными ролями участников 
различных процессов. 

5.2 Содействие проекту 

Мы узнали, что представляют собой различные рабочие процессы, также у вас должно 
быть достаточно хорошее понимание основ использования Сй. В этом разделе вы узнаете о 
нескольких типичных способах внести свой вклад в проект. 

Главная трудность в описании этого процесса состоит в том, что существует огромное 
количество вариаций того, как он организован. Так как Сіі очень гибок, люди могут осуществлять 
совместную работу по-разному, и проблематично описать то, как вы должны содействовать 
проекту — все проекты немного разные. Многое зависит от количества активных участников, 
от выбранного типа рабочего процесса, от ваших прав доступа к репозиториям, и, возможно, 
от метода принятия изменений от внешних разработчиков. 

Первый фактор — это количество активных участников. Как много пользователей активно 
вносят свой вклад в проект и как часто? Во многих случаях это два-три разработчика с несколькими 
коммитами в день, возможно, меньше, для вялотекущих проектов. В по-настоящему больших 
компаниях или проектах число разработчиков может измеряться тысячами, с десятками или 
даже сотнями ежедневно поступающих патчей. Это важно, поскольку с увеличением числа 
разработчиков вам становится труднее убедиться, что ваши изменения можно будет чисто 
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применить или беспрепятственно слить. Изменения, которые вы отправляете, могут оказаться 
устаревшими или частично сломанными той работой, которая была влита, пока вы работали, 
или пока ваши изменения ожидали утверждения или применения. Как сохранить свой код 
согласованным, а патчи применимыми? 

Следующий фактор — это рабочий процесс, используемый в проекте. Он централизован, 
и каждый разработчик имеет равные права на запись в главный репозиторий? Есть у проекта 
мейнтейнер или менеджер по интеграции, который проверяет патчи? Все ли патчи проверяются 
и утверждаются экспертами? Вы вовлечены в этот процесс? Присутствует ли система помощников 
и должны ли вы сначала отправлять свою работу им? 

Следующий пункт — это доступ на отправку изменений. Рабочий процесс, требуемый 
для внесения вклада в проект сильно отличается в зависимости от того, имеете ли вы доступ 
на запись или нет. Если у вас нет доступа на запись, то как в проекте принято принимать вклад 
в работу? Вообще, существует ли какая-либо политика? Какой объём работы вы вносите за 
раз? Как часто вы это делаете? 

Все эти вопросы могу повлиять на то, как эффективно вы будете вносить вклад в проект и 
какой рабочий процесс предпочтителен или доступен вам. Я расскажу об аспектах каждого из 
них на серии примеров, продвигаясь от простых к более сложным; на основе этих примеров 
вы сможете создать специфический нужный вам в вашей работе тип рабочего процесса. 

5.2.1 Рекомендации по созданию коммитов 

Прежде чем мы приступим к рассмотрению специфичных примеров использования, сделаем 
короткое замечание о сообщениях коммитов. Обладание хорошим руководством по созданию 
коммитов и следование ему значительно облегчает работу с СіІ'ом и сотрудничество с другими 
разработчиками. У проекта СіГ имеется документ с хорошими советами по созданию коммитов, 
из которых делаются патчи — прочитать его можно в исходном коде Сіг в файле Ооситеп - 
ІагЛоп/5иЬтіг.г.іпдРа1:сгіе5. 

Во-первых, не стоит отсылать ничего с ошибками в пробельных символах. СіГ предоставляет 
простой способ их обнаружения — перед коммитом, запустите діі. сИ'Г'Г - -сИеск, это 
определит возможные проблемы и перечислит их вам. Вот пример, в котором я заменил красный 
цвет терминала символами X: 



$ діг. сіі-гТ --сИеск 

ІіЬ/зітрІедіг. . гЬ : 5 : ігаіііпд иНііезрасе . 
+ @діт:_сІіг = Рііе . ехрапсІ_ра1:Н(ді1:_с1іг)ХХ 
ІіЬ/зітрІедіг. . гЬ : 7 : ігаіііпд иНііезрасе . 
+ ххххххххххх 

ІіЬ/зітрІеді.1: . гЬ : 26 : Г.гаі1іпд иИііезрасе. 
+ сіег' соттапсІ(ді(:_стсі)ХХХХ 



Если выполните эту команду перед коммитом, то сможете понять, собираетесь ли вы 
сделать коммит с раздражающими разработчиков ошибками в пробельных символах. 

Далее, старайтесь делать так, чтобы каждый коммит был логически отдельным набором 
изменений. Если можете, старайтесь делать ваши изменения обозримыми — не стоит писать 
код все выходные, работая над пятью задачами, а затем отправлять их все в понедельник одним 
массивным коммитом. Даже если вы не делали коммитов в течение выходных, воспользуйтесь 
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индексом, чтобы разбить свою работу на части, как минимум по одному коммиту для каждой 
проблемы с полезным сообщением к каждому Если некоторые из изменений затрагивают 
один и тот же файл, попробуйте использовать діі: асісі - - ра1:сИ для индексирования файла 
по частям (это подробно рассмотрено в Главе 6). Снимок состояния проекта на верхушке 
ветки будет идентичным, сделаете ли вы один коммит или пять, покуда все ваши изменения 
добавлены в какой-то момент, так что попытайтесь облегчить жизнь вашим коллегам разработчикам, 
когда они будут просматривать ваши изменения. При таком подходе будет проще выделить 
или отменить одно из изменений, если возникнет такая необходимость. В главе 6 описано 
множество полезных ухищрений для переписывания истории и интерактивного индексирования 
файлов — пользуйтесь этими инструментами для изготовления ясной и понятной истории. 

Последняя вещь, которую стоит иметь в виду, — это сообщение коммита. Написание 
качественных сообщений коммитов должно войти в привычку, это сделает сотрудничество с 
использованием С-іІ' а гораздо проще. По общему правилу, ваши сообщения должны начинаться 
с одной строки не длиннее 50 символов, лаконично описывающей набор изменений, затем 
пустая строка, затем более детальное описание. Проект С-іГ требует, чтобы детальное объяснение 
включало в себя мотивацию на изменения и противопоставляло вашу реализацию с предыдущим 
поведением — это хорошее руководство к действию. Если вы пишите сообщения к коммитам 
на английском языке, то хорошей идеей является использование повелительного наклонения 
глаголов в настоящем времени. Другими словами, пишите команды. Вместо «I аааесі №515 іоі» 
или «Аааіп§ іевй іоі» используйте «Ааа іевів иэг». 

Вот шаблон, изначально написанный Тимом Поупом на сайте Іроре.пеі: 
Краткое (до 50 символов) описание изменений 

Более детальное объяснение, если необходимо. Перенос на 72 символе 
или около того. В некоторых контекстах, первая строка рассматривается 
как тема письма, а остальное телом. Пустая строка, отделяющая сводку 
от тела важна (если вы не опустили тело целиком); если вы оставите их 
вместе, инструменты такие, как геЬазе, могут воспринять это неправильно. 

Дальнейшие параграфы идут после пустых строк 

- также можно применять маркеры списков 

- обычно в качестве маркера списка используется дефис или звёздочка, 
с одним пробелом перед ним и пустыми строками между пунктами, 
хотя соглашения в этом аспекте могут разниться 



Если все ваши сообщения о коммитах будут выглядеть как это, всё будет намного проще 
для вас и для разработчиков, с которыми вы работаете. Проект С-іГ содержит хорошо отформатированные 
сообщения о коммитах — я советую вам запустить діі Іод --по-шегдез там, чтобы 
увидеть, как выглядит хорошо отформатированная история коммитов проекта. 

В последующих примерах и почти везде в этой книге для краткости я не форматирую 
сообщения так красиво, как это; вместо этого я использую опцию - т для команды діі сот - 
тіі. Делайте, как я говорю, а не как я делаю. 
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5.2.2 Отдельная маленькая команда 

Наиболее простой тип организации, с которой вы легко можете столкнуться — частный 
проект с одним или двумя другими разработчиками. Под термином частный я подразумеваю 
закрытый код, недоступный для чтения остальному миру. Вы и все остальные разработчики 
имеете право записи в репозиторий. 

В этой среде вы можете придерживаться рабочего процесса, похожего на тот, который 
вы бы использовали в ЗиЬѵегвіоп или другой централизованной системе. Вы по-прежнему 
получите такие преимущества, как локальные коммиты (коммиты в оЯИпе) и возможность 
гораздо более простого ветвления и слияния, но сам рабочий процесс может оставаться очень 
похожим; главное отличие — во время выполнения коммита слияние происходит на стороне 
клиента, а не на сервере. Давайте посмотрим, как выглядел бы процесс, когда два разработчика 
начинают работать вместе с общим репозиторием. Первый разработчик, Джон, клонирует 
репозиторий, делает изменения и создаёт локальный коммит. (Я заменяю служебные сообщения 
знаком ... в этих примерах, чтобы немного их сократить.) 

# Машина Джона 

$ діі сіопе зоНп§ді(:Ііо5І: : зітріедіі . діг. 

Іпііііаіігесі етріу Сіі герозііогу іп /Ноте/]оИп/зітр1едіГ./.ді<:/ 

$ ссі зітріедіг./ 

$ ѵіт ІіЬ/зітрІедіі . гЬ 

$ діі соттіі: -ат ' гетоѵеа 1 іпѵаіісі а'е'ГаиН: ѵаіие 1 
[тазйег 738ее87] гетоѵесі іпѵаіісі а'е'ГаиН: ѵаіие 
1 -Гііез сНапдесІ, 1 іпзег1:іопз( + ) , 1 гіе1еГ.іопз( - ) 




Второй разработчик, Джессика, выполняет то же самое — клонирует репозиторий и делает 
коммит с изменениями: 

# Машина Джессики 

$ діі сіопе }еззіса§ді1:Но5І: : зітріедіі: . діг. 

Іпіііаіігесі етріу 6ІГ. герозііогу іп /Ноте/]е53іса/5ітр1еді(:/.діГ./ 

$ ссі зітріедіг./ 
$ ѵіт ТООО 

$ діг. соттіі: -ат 'асісі гезеі: г.азк' 
[тазііег ТЪТТБЪс] айй гезеі Г.азк 
1 -Гііез сИапдесІ, 1 іпзег1:іопз( + ) , Ѳ гіе1еГ.іопз( - ) 




Теперь Джессика отправляет свою работу на сервер: 



# Машина Джессики 




$ діг. ризИ огідіп тазіег 




То ]еззіса@ді1:Но5г. : зітріедіі: 


■ діс 


ІесіеебЬ . . тЪгТБЬс таз1:ег 


-> тазіег 
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Джон также пытается выложить свои изменения: 



# Машина Джона 

$ діі ризН огідіп тазіег 

То зопп§ді1:Ііо5І::5ітр1еді1:.ді1: 

! [гезес1:есі] тазііег -> тазіег (погѵГазІ: ■рогмага') 

еггог: ^аііесі 1:о ризіі зоте ге^з іо ' зоИпідііИозі : зітріедіі: . діі ' 



Джон не может выполнить отправку изменений, так как за это время Джессика уже отправила 
свои. Это очень важно понять, особенно если вы привыкли к ЗиЬѵегвіоп, так как мы видим, 
что эти два разработчика не редактировали один и тот же файл. Хотя ЗиЬѵегвіоп и выполняет 
автоматическое слияние на сервере, если редактировались разные файлы, при использовании 
Сіі вы должны слить коммиты локально. Прежде чем Джон сможет отправить свои изменения 
на сервер, он должен извлечь наработки Джессики и выполнить слияние: 



$ діі ■реіхіі огідіп 

Ргот ;]оПп@ді1:Ііо5І: :зітр1еді1: 
+ Ѳ49СІ078 . . . ТЪТТБЪс тазііег -> огідіп/тазііег 



На этот момент, локальный репозиторий Джона выглядит так, как показано на Рисунке 

5-4. 



таііег 



у 

4Ь078 ^ ^— ^ Іеаёе^ ^— ^738ее ^ 



^ ±Ы±5 ^ 



огідіп/таБіег 



Рисунок 5.4: Исходный репозиторий Джона. 

У Джона есть ссылка на изменения, выложенные Джессикой, и он должен слить их со 
своей работой перед тем, как ему разрешат её отправить: 



$ діі тегде огідіп/таз1:ег 
Мегде тасіе Ьу гесигзіѵе. 
ТСЮО | 1 + 

1 ■рііез сНапдесІ, 1 іпзег1:іопз( + ) , Ѳ сіе1е1:іоп5( - ) 
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Слияние прошло без проблем — история коммитов Джона теперь выглядит как на Рисунке 

5-5. 



• - - у 4Ь078 Іесіее ^ 738ее 72ЬЬс ^ 




ІЫІ5 



огідіп/таііег 



Рисунок 5.5: Репозиторий Джона после слияния с огідіп/тазіег. 

Теперь Джон может протестировать свой код, дабы удостовериться, что он по-прежнему 
работает нормально, а затем выложить свою работу, уже объединённую с работой Джессики, 
на сервер: 

$ діі ризіі огідіп таз(:ег 

То ;)0Ііп§ді1:Іі05І: : зітріедіі: . діі 

ТЬТТБЬс . . 72ЬЬс59 таз1:ег -> таз(:ег 



В результате история коммитов Джона выглядит, как показано на Рисунке 5-6. 




/ к 


к 


огідіп/таяег 



Рисунок 5.6: История коммитов Джона после отправки изменений на сервер. 

Тем временем, Джессика работала над тематической веткой. Она создала тематическую 
ветку с названием І55ііе54и сделала три коммита в этой ветке. Она ещё не извлекала изменения 
Джона, так что её история коммитов выглядит, как показано на Рисунке 5-7. 

Джессика хочет синхронизировать свою работу с Джоном, так что она извлекает изменения 
с сервера: 



# Машина Джессики 
$ дхі ТеісЬ огідіп 

Ргот ^е5зіса§ді1:^105^: : зітріедіі: 
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- - 4Ь078 ^ ІеДее ^ -«— ^ ^ 8149а "веб ) ~*~ ( 4а * 42 ) 



Рисунок 5.7: Исходная история коммитов Джессики. 



ТЬТТБЬс . . 72ЬЬс59 таз1:ег -> огідіп/тазііег 



Эта команда извлекает наработки Джона, которые он успел выложить. История коммитов 
Джессики теперь выглядит как на Рисунке 5-8. 



4Ь078 ^ Іеаеё"^ -*— ^ІЪІІЬ ^ 8149а ^ "«- ^ 23ас6 ^ - *- ^ 4а»«Д^ 




Рисунок 5.8: История коммитов Джессики после извлечения изменений Джона. 

Джессика полагает, что её тематическая ветка закончена, но она хочет узнать, с чем ей 
нужно слить свою работу, чтобы она могла выложить её на сервер. Она запускает діі. Іод, 
чтобы выяснить это: 



$ д±1 Іод --по-тегдез огідіп/тазіег Л іззие54 
соттіі 738ее872852сІг'аа9сі6634е0сіеа7а324Ѳ4Ѳ193016 
Аи1:пог: ЗоЬп Зтііп <ззті1:Н§ехатр1е.сот> 
йаіе: Ргі Мау 29 16:01:27 2009 -0700 

гетоѵесі іпѵаіісі йе'ГаиН: ѵаіие 



Теперь Джессика может слить свою тематическую ветку в ветку шазііег, слить работу 
Джона (огідіп/тазііег) в свою ветку тазііег и затем отправить изменения на сервер. 
Сначала она переключается на свою основную ветку, чтобы объединить всю эту работу: 



$ діі спескоиі: тазіег 
5иі1:сПесІ {.о ЬгапсН "тазГег" 

Ѵоиг Ьгапсіі із ЬеНіпсІ ' огідіп/тазіег ' Ьу 2 соттіііз, апсі сап Ье 1 = аз1:-1 ; огиагсІесі . 



Она может слить сначала ветку огідіп/та5І:ег,а может иІ55ие54 — обе они находятся 
выше в истории коммитов, так что не важно какой порядок слияния она выберет. Конечное 
состояние репозитория должно получиться идентичным независимо от того, какой порядок 
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слияния она выберет; только история коммитов будет немного разная. Она решает слить ветку 
І55ііе54 первой: 



$ діі тегде іззие54 
Іірсіаііпд ГЬгТбЬс. .4аГ4298 
Разі г'опл/аго' 

КЕАРМЕ | 1 + 

1іЬ/зітр1еді1: . гЬ | 6 +++++- 

2 ■рііез сНапдесІ, 6 іпзег1:іопз( + ) , 1 сіе1е1:іоп5( - ) 



Никаких проблем не возникло; как видите, это был обычная перемотка. Теперь Джессика 
сливает работу Джона (огідіп/шазііег): 



$ діі тегде огідіп/тазііег 
Аиіо-тегдіпд 1іЬ/зітр1еді1: . гЬ 
Мегде тасіе Ьу гесигзіѵе. 
1іЬ/зітр1еді1: . гЬ | 2 +- 

1 ■рііез сИапдесІ, 1 іпзег1:іопз( + ) , 1 сіе1е1:іоп5( - ) 

Слияние проходит нормально, и теперь история коммитов Джессики выглядит так, как 
показано на Рисунке 5-9. 




4 



Рисунок 5.9: История коммитов Джессики после слияния с изменениями Джона. 

Теперь указатель огідіп/шазііег доступен из ветки тазііег Джессики, так что она 
может спокойно выполнить діі. риз И (полагая, что Джон не выкладывал свои изменения за 
это время): 



$ діі ризИ огідіп тазііег 

То зеззіса@ді1:Ііоз1: : зітріедіі: . діі: 

72ЬЬс59. .8Ѳ59СІ5 таз1:ег -> тазСег 



Каждый разработчик несколько раз выполнял коммиты и успешно сливал свою работу с 
работой другого; смотри Рисунок 5-10. 

Это один из простейших рабочих процессов. Вы работаете некоторое время, преимущественно 
в тематической ветке, и, когда приходит время, сливаете её в свою ветку та5Г_ег. Когда 
вы готовы поделиться этой работой с другими, вы сливаете её в ветку та5Г_ег, извлекаете 
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Рисунок 5.10: История коммитов Джессики после отправки всех изменений обратно на сервер. 

изменения с сервера и сливаете огідіп/шазііег (если за это время произошли изменения), 
и, наконец, отправляете свои изменения в ветку таз г на сервер. Общая последовательность 
действий выглядит так, как показано на Рисунке 5-11. 



.Зеззіса 






1 


.Эогіп 

>- 



діі соттіі 



1І 



діі тегде 



3 



^ діі сіопе (игр 



діі ривН огідіП | 



д№ сіопе (игі) ■ 



дИ (еі&і огідіп» 



|ДД Ыг.Ь огідіп 



дИ ризЬ огідіп . 



. дИ ризЬ огідіп 



діі соттіі 



діі тегде 



3 



.Зеззіса 








» ^ 

.зоИп 



Рисунок 5.11: Общая последовательность событий для простого рабочего процесса с несколькими 
разработчиками в Ск'е. 



5.2.3 Отдельная команда с менеджером 

В этом сценарии мы рассмотрим роли участников проекта в закрытых группах большего 
размера. Вы научитесь работе в окружении, где маленькие группы совместно работают над 
задачами, а затем результаты их деятельности интегрируются отдельным субъектом. 

Давайте представим, что Джон и Джессика работают вместе над одной задачей, в то время 
как Джессика с Джози работают над другой. В этом случае компания использует рабочий 
процесс с менеджером по интеграции, при котором работа частных групп объединяется только 
определёнными инженерами (обновление ветки таз 1: е г главного репозитория может осуществляться 
только этими инженерами). В этом случае вся работа выполняется в ветках отдельных команд 
разработчиков и впоследствии объединяется воедино менеджерами по интеграции. 
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Давайте проследим за рабочим процессом Джессики, которая работает над двумя задачами, 
сотрудничая одновременно с двумя разными разработчиками. Положим, что она уже имеет 
свою собственную копию репозитория. Джессика решает сначала взяться за задачу Теа- 
ііи г еА. Для этого она создаёт новую ветку и выполняет в ней некоторую работу: 

# Машина Джессики 
$ діі сііескоиг. -Ь -реаіигеА 
5иіг.сІіесІ Ьо а пей ЬгапсИ "■Геаг.игеА" 
$ ѵіт ІіЬ/зітрІедіі . гЬ 

$ діг. соттіі: -ат 'асісі Іітіг. іо Іод ■Гипсг.іоп' 
[геаІигеА 3300904] асісі Іітіі Но Іод типсГ.іоп 
1 г'Иез сНапдесІ, 1 іпзег1:іопз( + ) , 1 гіе1еГ.іопз( - ) 



На этом этапе ей требуется поделиться своей работой с Джоном, так что она отправляет 
коммиты, выполненные на ветке г"еаг_игеА, на сервер. Так как Джессика не имеет право на 
изменение ветки таз г. е г на сервере — только менеджеры по интеграции могут делать это 
— она вынуждена отправлять свои изменения в другую ветку, чтобы обмениваться работой с 
Джоном: 

$ діі ризИ огідіп -реаіигеА 

То ]еззіса@ді1:Но5І::зітр1едіг..ді1: 
* [пеы ЬгапсН] -реаГ-игеА -> -реа1:игеА 



Джессика сообщает по электронной почте Джону, что она выложила некоторые наработки 
в ветку г"еа1:игеА, и что он может проверить их. Пока Джессика ждёт ответа от Джона, она 
решает начать работу над веткой г"еа1:игеВ вместе с Джози. Для начала она создаёт новую 
ветку для этой задачи, используя в качестве основы ветку шазііег на сервере: 

# Машина Джессики 
$ діі т"ег.сІі огідіп 

$ діг. сііескоиг. -Ь т'еаг.игеВ огідіп/таз1:ег 
5міг.сІіесІ Г.о а пей Ьгапсп "г"еаг.игеВ" 



Теперь Джессика делает пару коммитов в ветке 'РеаІіигеВ: 



$ ѵіт ІіЬ/зітрІедіі . гЬ 

$ діі соттіг. -ат 'тасіе 1:Кіе Із-Сгее 1"ипс1:іоп гесигзіѵе' 
[Те&іигеВ еБЬО'Го'с] тасіе т:Ие 1з-1гее 1 = ипс1:іоп гесигзіѵе 

1 -Гііез сИапдесІ, 1 іпзег1:іопз( + ) , 1 о'е1е1:іопз( - ) 
$ ѵіт ІіЬ/зітрІедіі . гЬ 
$ діі соттіі: -ат 'асісі Із-^ііез 1 
[ГеаІигеВ 8512791] асісі 1з--Гі1ез 

1 -Гііез сИапдесі, 5 іпзег1:іопз( + ) , 0 с1е1е1:іопз( - ) 
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Рисунок 5.12: Исходная история коммитов у Джессики. 



Репозиторий Джессики выглядит, как показано на Рисунке 5-12. 

Джессика уже готова отправить свою работу на сервер, но получает от Джози сообщение 
о том, что некоторые наработки уже были выложены на сервер в ветку ^еаііи г еВее. Поэтому 
Джессика должна сначала слить эти изменения со своими, прежде чем она сможет отправить 
свою работу на сервер. Она может извлечь изменения Джози командой діХ 'ГеІісИ: 



$ діі ■реіхіі огідіп 

Ргот зеззісаідіІіИозі : зітріедіі: 
* [пем ЬгапсН] ■реаГигеВее -> огідіп/^еаІіигеВее 



Теперь Джессика может слить эти изменения в свои наработки командой діі: тегде: 



$ діі тегде огідіп/РеаІіигеВее 
Аиіо-тегдіпд 1іЬ/зітр1еді1: . гЬ 
Мегде тасіе Ьу гесигзіѵе. 
1іЬ/зітр1еді1: . гЬ | 4 ++++ 

1 ■рііез сНапдесІ, 4 іпзег1:іопз( + ) , Ѳ сІе1е1:іоп5( - ) 



Есть небольшая проблема — ей нужно выложить изменения из своей ветки 'ГеаІіигеВ 
в ветку 1 = еа1:игеВее на сервере. Она может сделать это при помощи команды діі: ризИ, 
указав название локальной и удалённой ветки, разделённые двоеточием: 



$ діі ризН огідіп ■реа(:игеВ:'Геа1:игеВее 

То зеззіса§ді1:Иоз1: : зітріедіі: . дИ 

РЬаЭа-рв . . ссІ685сІ1 -ГеаГигеВ -> -реаГигеВее 



Это называется ге/зрес. Смотри Главу 9, где более детально обсуждаются спецификации 
ссылок и различные вещи, которые вы можете делать с ними. 
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Далее, Джон сообщает Джессике по почте, что он добавил некоторые изменения в ветку 
г"еаг_и г еА и просит её проверить их. Она выполняет діі г"е1:сІ~і, чтобы получить внесённые 
Джоном изменения: 



$ діг. ТеісЬ огідіп 




Ргот зеззісаідіІіИозІ: 


: зітріедіг. 


330Ѳ9Ѳ4. .аасі881сІ 


■Геа1:игеА -> огідіп/-ГеаіигеА 



Затем, используя команду діі Іод, она смотрит, что же было изменено: 



$ діг. Іод огідіп/т"еаг_игеА Л т"еаг.игеА 
соттіі ааа , 881а , 154ассІаеЬ2Ь6Ы8еа0е827есШа6а , 671е6 
Аиг.Иог: ЗоЬп ЗтііЬ <^зті1:Н§ехатр1е.сот> 
Оаіе: Ргі Мау 29 19:57:33 2ѲѲ9 -07ѲѲ 

сНапдес! Іод оиіриі Г.о 30 ггот 25 



Наконец, она сливает работу Джона в свою собственную ветку г"еа1:игеА: 



$ діг. сПескоиГ. г"еаг_игеА 
5иіі:сІіес1 Ьо ЬгапсИ "т'еаг.игеА" 
$ діг. тегде огідіп/т^еаг-игеА 
ирсіаііпд 3300904. .аас1881й 
Разі г'опл/аго' 

ІіЬ/зітрІедіг. . гЬ | 10 +++++++++- 
1 г'Иез сНапдео', 9 іпзег1:іопз( + ) , 1 сіе1е1:іопз( - ) 



Джессика хочет кое-что подправить, так что она опять делает коммит и затем отправляет 
изменения на сервер: 

$ діі соттіі: -ат 1 зтаіі г-меак' 
[г"еаг.игеА ео774ЬЗ] зтаіі г.иеак 
1 -рііез сііапдесі, 1 іпзег1:іопз( + ) , 1 йе1еГ.іопз( - ) 
$ діі ризИ огідіп -ГеаіигеА 

То ]еззіса@ді1:Но5І: : зітріедіг. . діГ. 

3300904. .еа774ЬЗ теаИигеА -> геаГ.игеА 



История коммитов Джессики теперь выглядит так, как показано на Рисунке 5-13. 

Джессика, Джози и Джон информируют менеджеров по интеграции, что ветки г"еаг_ и г еА 
и г"еа1:игеВее на сервере готовы к интеграции в основную ветку разработки. После того, 
как они интегрируют эти ветки в основную версию, извлечение данных с сервера приведёт к 
появлению новых коммитов слияния. Таким образом, история коммитов станет выглядеть так, 
как на Рисунке 5-14. 
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Рисунок 5.13: История Джессики после внесения коммитов в ветку с решаемой задачей. 




- 4Ь07В ^ ІеЛее^ '»— ^ 33009 ^ 88(168 ^ 77<ЬЗ ^ 

^о5Ь0{ 85127 ) 





Рисунок 5.14: История коммитов Джессики после слияния двух тематических веток. 



Множество групп переходят на СіІ именно из-за возможности параллельной работы нескольких 
команд с последующим объединением разных линий разработки. Огромное преимущество 
Ск'а — возможность маленьких подгрупп большой команды работать вместе через удалённые 
ветки, не мешая при этом всей команде. Последовательность событий в рассмотренном здесь 
рабочем процессе представлена на Рисунке 5-15. 



5.2.4 Небольшой открытый проект 

Внести вклад в открытый проект — это немного другое. Из-за того, что у вас нет прав на 
прямое изменение веток проекта, требуется какой-нибудь другой путь для обмена наработками 
с мейнтейнерами. Первый пример описывает участие в проекте через разветвление (Тогк) на 
Сіі-хостингах, на которых это делается достаточно просто. Сайты геро.ог.С2 и СііНиЬ оба 
поддерживают такую возможность, и большая часть мейнтейнеров проектов придерживаются 
такого способа сотрудничества. В следующем разделе рассматриваются проекты, которые 
предпочитают принимать патчи по е-таіі. 

Сначала вы скорее всего захотите склонировать основной репозиторий, создать тематическую 
ветку для одного или нескольких патчей, которые вы собираетесь внести в проект, и выполнить 
свою работу в ней. Последовательность действий выглядит следующим образом: 
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діі соттИ оп Д 



діі тегде оп А 



3 



д\Х соттИ оп еГ| 



:і' м .- ]- і | 



діГсоттіт. оп еГ| 



■1 г .■ |г 



ді(гпегде«^^ 



дй соттИ оп А I 



Зе55Іса .ЪЬп ^5Іе 5егѵег:ГеаІигеА 5егѵег:ГеаІигеВее 



Рисунок 5.15: Основная последовательность действий для рабочего процесса в команде с менеджером 
по интеграции. 



$ діг. сіопе (игі) 
$ ссі рго^есі 

$ діі спескоит. -Ь ^еаіигеА 
$ (выполнение работы) 
$ діі соттіт. 
$ (выполнение работы) 
$ діі сотшіг. 



Возможно, у вас возникнет желание воспользоваться г еЬазе -і, чтобы сплющить (эдиавп) 
свои наработки в единый коммит, или реорганизовать наработки в коммитах таким образом, 
чтобы их было проще воспринимать мейнтейнерам проекта — об интерактивном перемещении 
будет рассказано в Главе 6. 

Если вы закончили работу со своей веткой и готовы поделиться наработками с мейнтейнерами, 
перейдите на страницу исходного проекта и нажмите кнопку «Рогк», создав таким образом 
свою собственную копию проекта доступную на запись. Затем вам нужно добавить 1ЖЬ этого 
нового репозитория в список удалённых репозиториев, в нашем случае мы назовём его ту - 
■рогк: 



$ діі гетог_е асісі туГогк (игі) 



Вам нужно отправить свои наработки в этот репозиторий. Проще всего будет отправить 
в удалённый репозиторий ту ветку, над которой вы работаете, а не сливать её в ветку тазііег 
и отправлять потом его. Это объясняется следующим образом — если ваша работа не будет 
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принята или будет принята только частично, вам не придётся откатывать назад свою ветку 
тазііег. Если мейнтейнеры сольют, переместят или частично включат вашу работу, вы, в 
конечном счёте, получите её обратно при получении изменений из их репозитория: 



$ діі ризН туГогк -реаіигеА 



Когда ваши наработки будут отправлены в ваш форк, вам нужно будет послать уведомление 
мейнтейнеру Его часто называют запросом на включение (риіі гедиезі), вы можете либо сгенерировать 
его через сайт — на СіШиЪ'е есть кнопка «риіі гедиеві», автоматически уведомляющая мейнтейнера, 
либо выполнить команду д і 1: гедиез1:-ри11и вручную отправить её вывод по почте мейнтейнеру. 

Команда гедиезі: - риіі принимает в качестве аргумента имя базовой ветки, в которую 
вы хотите включить свою работу, и ІЖЬ репозитория, из которого мейнтейнер может получить 
ваши наработки. Команда выводит короткую сводку всех изменений, которые вы просите 
включить в проект. Например, если Джессика хочет послать Джону запрос на включение, 
когда она сделала пару коммитов в тематической ветке и уже отправила её на сервер, ей следует 
выполнить следующее: 



$ діі гедиез1:-ри11 огідіп/шазіег туГогк 

ТИе -Гоііоміпд сИапдез зіпсе соттіі 1ес1ее6ЫсІ61823а2с1еЗЬѲ9с160сІ7Ѳ8ѲЬ8сІ1ЬЗа4Ѳ : 
;іоііп ЗтіИН (1) : 

асі сіесі а пей -рипсіііоп 

аге аѵаіІаЫе іп іпе длЛ герозііогу аі: 

діі : //дИпозЬ/зітрІедіІ: . діі -ГеаіигеА 

^ззіса Зті1:И (2) : 

асісі Іітіі Ьо Іод ^ипсЬіоп 
сііапде Іод оиіриі: Ьо 30 -Ггот 25 

1іЬ/зітр1еді1: . гЬ | 10 +++++++++- 

1 -Гііез сИапдесІ, 9 іпзег1:іопз( + ) , 1 с!е1е1:іопз( - ) 



Вывод может быть отправлен мейнтейнеру — он содержит список коммитов, информацию 
о том, где начинается ветка с изменениями, и указывает откуда можно забрать эти изменения. 

Для проекта, мейнтейнером которого вы не являетесь, проще иметь ветку таз 1: е г, которая 
отслеживает ветку огідіп/тазііег, и выполнять работу в тематических ветках, которые 
вы легко сможете удалить, в случае если они будут отклонены. Если вы распределяете свои 
наработки по различным темам в тематических ветках, вам будет проще выполнить перемещение 
своей работы, в случае если верхушка главного репозитория переместится за время работы и 
ваши коммиты уже не получится применить без конфликтов. Например, если вы планирует 
отправить в проект работу по другой теме, не продолжайте работать внутри тематической 
ветки, которую вы только что отправили, начните снова с ветки таз г главного репозитория: 



$ діі сііескоиі: -Ь -реаіигеВ огідіп/таз1:ег 
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$ (выполнение работы) 
$ діг. соттіг. 

$ діг. ризп туГогк т'еаг.игеВ 

$ (отправка письма мейнтейнеру) 

$ діі т'ег.сп огідіп 



Теперь каждая из ваших тем представляет собой нечто похожее на очередь из патчей, 
которую вы можете перезаписывать, перемещать, модифицировать, не оказывая влияние на 
остальные, как на Рисунке 5-16. 



гтшіег 




огідіп/таяег 











---^ 4Ь078 ^ ІеДее ^ 33009 ^ 




Рисунок 5.16: Исходная история коммитов при работе над (еаіигеВ. 



Давайте представим, что мейнтейнер проекта включил в основную версию чью-то группу 
патчей. Затем он попытался включить вашу первую ветку, но слияние уже не проходит гладко. 
В этом случае вы можете попробовать переместить эту ветку на верхушку ветки огідіп/ 
тазііег, разрешить конфликты для мейнтейнера и затем заново представить свои изменения 
на рассмотрение: 



$ діг. спескоиг. т"еаг_игеА 
$ діг. геЬазе огідіп/таз1:ег 
$ діг. ризп -Т туГогк ■реаг.игеА 



Так вы перепишете свою историю коммитов, чтобы она выглядела так, как на Рисунке 



5-17. 



I 



огідіп/таэіег 



«- - 4Ь078 Івавё"^ ^ 33009 ^ 



^ 5399е Г 




Рисунок 5.17: История коммитов после работы в (еаіигеА. 



Так как вы переместили ветку, команде ризп вы должны передать опцию - Т, чтобы иметь 
возможность заменить ветку 'ГеаІіигеА на сервере. Есть альтернатива — выложить новую 
работу на сервер в другую ветку (возможно, назвав её 1 = еа1:игеАѵ2). 
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Давайте рассмотрим более вероятный сценарий: мейнтейнер просмотрел на вашу работу 
во второй ветке и ему понравилась ваша идея, но он хотел бы, чтобы вы изменили некоторые 
детали реализации. Воспользуемся этой возможностью, чтобы заодно переместить вашу работу 
так, чтобы она базировалась на текущей версии ветки тазііег в проекте. Создадим новую 
ветку, базирующуюся на текущей ветке огідіп/тазііег, уплотним (вциазЬ) здесь изменения 
из ветки 'РеаІіигеВ, разрешим все конфликты, которые могут возникнуть, сделаем необходимые 
изменения в реализации вашей идеи и затем выложим всё это в виде новой ветки: 



$ діі спескоиі: -Ь ■реа(:игеВѵ2 огідіп/таз1:ег 
$ діі тегде --по-сотті1: --здиазН ■реаІіигеВ 
$ (изменение реализации) 
$ діі соттИ 

$ діі ризН туРогк ■реаіигеВѵг 



Опция - -здиазН берёт всю работу на сливаемой ветке (йеайігеВ) и сжимает её в один 
коммит, не являющийся коммитом-слиянием, и помещает его на верхушку текущей ветки. 
Опция - -по-сотшіі: сообщает Сй'у, что не нужно автоматически записывать коммит. Это 
позволит вам внести все изменения с другой ветки и затем сделать ещё ряд изменений перед 
записью нового коммита. 

Теперь вы можете отправить мейнтейнеру сообщение о том, что вы сделали требуемые 
изменения, и они могут быть найдены в вашей ветке 1 = еа1:игеВѵ2 (смотри Рисунок 5-18). 



Гпаііег I I опдт/таііег 



Т 




^ аеебЬ — ^ 5399е — Ц 



^ е5Ь05 



Рисунок 5.18: История коммитов после работы над [еаіигеВѵ2. 



5.2.5 Большой открытый проект 

Во многих крупных проектах есть установленные процедуры принятия патчей — вам 
потребуется выяснить точные правила для каждого проекта отдельно, так как они везде разные. 
Однако, многие крупные открытые проекты принимают патчи через списки рассылки для 
разработчиков, так что мы сейчас рассмотрим пример использования этого способа. 

Рабочий процесс похож на описанный ранее — вы создаёте тематическую ветку для каждой 
серии патчей, над которой работаете. Отличие состоит в процессе внесения этих изменений 
в проект. Вместо того, чтобы создавать ответвление (гогк) от проекта и отправлять наработки 
в свой собственный репозиторий с правами на запись, вы генерируете е-таіі версию каждой 
серии коммитов и отправляете её в список рассылки для разработчиков: 
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$ діг. спескоиг. -Ь іорісА 
$ (выполнение работы) 
$ діг. соттіг. 
$ (выполнение работы) 
$ діг. соттіг. 



Теперь у нас есть два коммита, которые теперь нужно отправить в список рассылки. Воспользуемся 
командой діі: гогтаі: - раіісгі, чтобы сгенерировать файлы в формате тЬох, которые вы 
сможете отправить по почте. Эта команда превращает каждый коммит в электронное письмо, 
темой которого является первая строка сообщения коммита, а оставшаяся часть сообщения 
коммита и патч, который он представляет, являются телом письма. Хорошей особенностью 
этого является то, что применение патча из сгенерированного командой го г шаі - раіісгі электронного 
письма сохраняет всю информацию о коммите. Мы увидим это в следующем разделе, когда 
будем применять такие патчи: 

$ діг. г'огтаг.-раг.сп -М огідіп/тазіег 
ѲѲѲІ-асІсІ-Іітіг.-г.о-Іод-^ипсг.іоп . раісп 
0002-спапдеа'-1од-оиг.ри1:-1:о-30-г'гот-25 . рагхп 



Команда ^огтаі: - раЁсН создаёт файлы с патчами и выводит их названия. Опция - 
М сообщает СіІ'у о необходимости отслеживания переименований файлов. Итоговые патчи 
выглядят так: 

$ саг. 00Ѳ1-асІсІ-1ітіі-іо-1од-г'ипсг.іоп . рагхп 

Ргот 330090432754092а , 704а , а8е76са5с05с198е71а8 Моп 5ер 17 00:00:00 2001 

Ргот: .Іеззіса Зтііп <^еззіса§ехатр1е . сот> 

ОаСе: 5ип, 6 Арг 2008 10:17:23 -0700 

5иЬ]есі: [РАТСН 1/2] асісі Іітіг. Со Іод г"ипсг.іоп 

І_ітіг. Іод ■Гипсг.іопаііг.у Со г.пе ■рігзг. 20 



ІіЬ/зітрІедіг. . гЬ | 2 +- 

1 г'Иез спапдесі, 1 іпзег1:іопз( + ) , 1 ае1е1:іопз( - ) 

біТТ --діг. а/ІіЬ/зітрІедіг. . гЬ Ь/ІіЬ/зітрІедіг. . гЬ 
іпсіех 76тЧ7Ьс. .-Г9815П 100644 
— а/ІіЬ/зітрІедіг. . гЬ 
+++ Ь/ІіЬ/зітрІедіг. . гЬ 
іі -14,7 +14,7 §§ сіазз Зітріебіг. 
епсі 

беТ 1од(г.гееізп = 'тазСег') 
соттапсіСдіг. Іод #{г.гееізп}" ) 
+ соттапа^ "діг. Іод -п 20 #{г.гееізп}" ) 
епсі 

сІе-Г І5_г.гее(Г.гееізп = 'тазСег') 
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Вы также можете отредактировать эти файлы с патчами, чтобы добавить в электронное 
письмо какую-то информацию, которую вы не хотите показывать в сообщении коммита. Если 
вы добавите текст между строкой - - и началом патча (строка ІІЬ/зітрІедіІ: . г Ь), то разработчик 
сможет его прочитать, а при применении патча он будет выброшен. 

Чтобы отправить эти файлы в список рассылки, вы можете либо вставить файл в своём 
почтовом клиенте, либо отправить его через специальную программу из командной строки. 
Вставка текста часто приводит к ошибкам форматирования, особенно в «умных» клиентах, 
которые не сохраняют символы перевода строки и пробельные символы в исходном виде. К 
счастью, СіІ предоставляет инструмент, позволяющий вам передавать через ІМАР правильно 
отформатированные патчи. Для вас применение этого инструмента может оказаться более 
простым. Я покажу как отсылать патчи через Стаіі, так как именно этот агент я и использую; 
вы можете прочесть подробные инструкции для множества почтовых программ в вышеупомянутом 
файле 0оситеп1:а1:іоп/5иЬті1:1:іпдРа1:сИе5, находящемся в исходном коде СИ'а. 

Для начала нам необходимо настроить секцию ітар в файле -/.діІісогтРід. Можете 
добавить все значения по одному несколькими командами діі согтРід, или можете добавить 
их все сразу вручную; но в итоге ваш файл конфигурации должен выглядеть примерно так: 



[ітар] 

гоісіег = " [бтаЩ/ОгаПз" 

Ьозі = ітарз : //ітар . дтаіі . сот 

изег = изегідтаіі. сот 

разз = р4ззм0гсІ 

рогі = 993 
ззіѵегі-ру = -Гаізе 




Если ваш ІМАР-сервер не использует 55Ь, две последние строки могут отсутствовать, а 
параметр Ьозі примет значение ітар : / / вместо ітарз : / /. Когда закончите с настройками, 
воспользуйтесь командой діі: зепсі-етаіі, чтобы поместить свою серию патчей в папку 
Бгайв на указанном ІМАР-сервере: 



$ діі зепсі-етаіі * .раі.сЬ 
ѲѲѲІ-асІсІегі-ІітіІі-Ііо-Іод-^ипсііоп . раісЬ 
0ѲѲ2-сИапдесі-1од-ои(:ри1:-1:о-30--Ггот-25 . раісЬ 

МЬо зпоиісі 1:Не етаііз арреаг іо Ье 'Ргот? [^еззіса 5ті1:И <]еззіса@ехатр1е . сот>] 
Етаііз іл/ііі Ье зепі: ■ргот: .Зеззіса 5ті1:И <зеззіса@ехатр1е . сот> 
ѴІЬо зііоиісі 1іИе етаііз Ье зепі Іо? зеззісаіехатріе . сот 
Меззаде-Ю Іо Ье изесі аз Іп-Реріу-То -Тог 1:Ье -Гігзі: етаіі? у 



Затем СіГ выдаёт кучу служебных сообщений, которые для каждого отсылаемого патча 
выглядят следующим образом: 
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(шЬох) Асісііпд сс: Зеззіса 5тіг.Н <зеззіса§ехатр1е.сот> гтот 

\1іпе 'Ргот: ^еззіса 5ті1:И <]еззіса@ехатр1е.сот>' 
ОК. І-од зауз: 

Зепсітаіі: /изг/зЫп/зепсітаіІ -і зеззіса§ехатр1е.сот 
Ргот: .Зеззіса ЗтііИ <^еззіса§ехатр1е . сот> 
То: ]еззіса§ехатр1е . сот 

5иЬ]есі: [РАТСН 1/2] асісіесі Іітіг. Со Іод типсііоп 
Оаіе: 5аИ, 30 Мау 2009 13:29:15 -0700 

Меззаде-Іо' : <1243715356- 61726- 1-діі-зепсІ-етаіІ-зеззісаіехатрІе . сот> 
Х-Маііег: діі-зепсі-етаіі 1 . 6 . 2 . гсі. 20 . д8с5Ь . сІігг.у 
Іп-Реріу-То: <у> 
Кет"егепсез: <у> 

Кезиіі: ОК 



Если всё прошло успешно, то сейчас вы можете перейти в свою папку Бгапв, изменить 
поле 'То' на адрес списка рассылки, в который вы собираетесь послать патчи, возможно, указать 
адрес мейнтейнера или лица отвечающую за нужную часть проекта в поле 'СС и отправить 
сообщение. 

5.2.6 Итоги 

В этом разделе мы рассмотрели ряд общепринятых рабочих процессов, применяемых в 
разных типах проектов использующих СіІ, с которыми вы наверняка столкнётесь. Также были 
представлены несколько новых инструментов, призванных помочь вам в организации этих 
процессов. Далее мы рассмотрим, как осуществляется работа с противоположной стороны 
баррикады — как сопровождать проект использующий СіГ. Вы научитесь роли благосклонного 
диктатора или роли менеджера по интеграции. 

5.3 Сопровождение проекта 

В дополнение к тому, как эффективно работать над проектом, вам, наверняка, необходимо 
также знать как самому поддерживать проект. Сопровождение проекта может заключаться в 
принятии и применении патчей, сгенерированных с помощью 'югтаІ-раІсЬ' и отправленных 
вам по почте, или в интеграции изменений из веток тех репозиториев, которые вы добавили в 
качестве удалённых (гетоіев) для вашего проекта. Неважно, поддерживаете ли вы эталонный 
репозиторий проекта или хотите помочь с проверкой и утверждением патчей, вам необходимо 
выработать метод приёма наработок, который будет наиболее понятным для других участников 
и не будет изменяться в течении длительного срока. 

5.3.1 Работа с тематическими ветками 

Если вы решаете интегрировать ли новые наработки, как правило неплохо было бы опробовать 
их в какой-нибудь временной тематической ветке, специально созданной для их тестирования. 
Так будет легче подправить отдельные патчи или забросить их до лучших времён, если что- 
то не работает. Если вы дадите ветке простое имя, основанное на теме работы содержащейся в 
ней, например, г и Ьу_с1іе п или как-нибудь так же наглядно, то вы сможете легко вспомнить, 
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для чего эта ветка, если вам вдруг придётся отложить работу с ней и вернуться к ней позднее. 
В проекте СіІ мейнтейнер, как правило, создаёт ветки с добавлением пространства имён — к 
примеру, '5с/гаЬу_с1іеп1:', где 'вс' — это сокращённое имя автора, приславшего свою работу. 
Как вы уже знаете, создать ветку, основанную на вашей ветке тазііег, можно следующим 
образом: 

$ діі Ьгапсп зс/гиЬу_с1іеп1: тазйег 



Или, если вы хотите сразу переключиться на создаваемую ветку, можно воспользоваться 
командой с И ее кои 1: -Ь: 

$ діі сИескоиІ: -Ь зс/гиЬу_с1іеп1: тазГег 



Теперь вы готовы к тому, чтобы принять изменения в данную тематическую ветку и определить, 
хотите ли вы влить их в свои стабильные ветки или нет. 

5.3.2 Применение патчей, отправленных по почте 

Если вы получили по электронной почте патч, который вам нужно интегрировать в свой 
проект, вам необходимо применить патч в тематической ветке, чтобы его оценить. Есть два 
способа применения отправленных по почте патчей: с помощью команды діі арріу или 
команды діі: ат. 

Применение патчей с помощью команды арріу Если вы получили чей-то патч, сгенерированный 
с помощью команды діі. сИ'Г'Г или Ііпіх-команды сИ'Г'Г, вы можете применить его при помощи 
командыдіі: арріу. Полагая, что вы сохранили патчв /1:тр/ра1:сгі - шЬу-сІіепІ: . раісгі, 
вы можете применить его следующим образом: 

$ діі арріу /1:тр/ра(:сп-гиЬу-с1іеп(: . раГсН 



Эта команда внесёт изменения в файлы в рабочем каталоге. Она практически идентична 
выполнению команды раіісгі -рі для применения патча, хотя она более параноидальна и 
допускает меньше нечётких совпадений, чем раісгі. К тому же она способна справиться с 
добавлением, удалением и переименованием файлов, описанными в формате діі сИ'Г'Г, чего 
команда ра1:сН сделать не сможет. И наконец діі: арріу реализует модель «применить 
всё или ничего», тогда как ра1:сН позволяет частично применять патч-файлы, оставляя ваш 
рабочий каталог в странном и непонятном состоянии. Команда діі арріу в целом гораздо 
более параноидальна, чем раі: с И . Она не создаст для вас коммит — после выполнения команды 
вы должны вручную проиндексировать внесённые изменения и сделать коммит. 

Кроме того, вы можете использоваться діі арріу, чтобы узнать, чистоли накладывается 
патч, ещё до того, как вы будете применять его на самом деле — для этого выполните діі ар - 
ріу - - сИеск, указав нужный патч: 



134 



5соП СЬасоп Рго Сіі 



Раздел 5.3 Сопровождение проекта 



$ діі арріу --спеск ООѲІ-зееіпд-і^-Ііпіз-пеІрз-іпе-деггі.раІісп 
еггог: раГсп т"аі1есі : іісдіі: . детзрес : 1 
еггог: іісдіі: . детзрес : ра1:сп сіоез поі: арріу 

Если никакого вывода нет, то патч должен наложиться без ошибок. Если проверка прошла 
неудачно, то команда завершится с ненулевым статусом, так что вы можете использовать её при 
написании сценариев. 

Применение патчей с помощью команды ат Если разработчик является достаточно хорошим 
пользователем Сіг и применил команду ^огтаі - раісгі для создания своего патча, то ваша 
задача становится проще, так как такой патч содержит информацию об авторе и сообщение 
коммита. Если есть возможность, поощряйте участников проекта на использование команды 
гогтаі: - раіісгі вместо сіігТ при генерировании патчей для вас. Команду діі арріу стоит 
использовать, только если нет другого выхода, и патчи уже созданы при помощи сИ'Г'Г. 

Чтобы применить патч, созданный при помощи ^огтаі -раісгі, используйте команду 
діі: ат. С технической точки зрения, діі ат читает тЬох-файл, который является простым 
текстовым форматом для хранения одного или нескольких электронных писем в одном текстовом 
файле. Он выглядит примерно следующим образом: 

Ргот 330090432754092а , 704а , а8е76са5с05с198е71а8 МОП 5ер 17 Ѳ0:0Ѳ:ѲѲ 2001 

Ргот: Оеззіса Зтііп <^еззіса§ехатр1е . сот> 

Оаіе: 5ип, 6 Арг 2008 10:17:23 -0700 

5иЬ]есі: [РАТСН 1/2] асісі Іітіі Со Іод гипсііоп 

ИтИ Іод ■рипсіііопаіііу Ьо іЬе г"ігз1: 20 

Это начало вывода команды ^огтаі - раісгі, который мы уже видели в предыдущем 
разделе. Это одновременно и правильный тЬох формат для е-таіі. Если кто-то прислал вам 
по почте патч, правильно воспользовавшись для этого командой діі: зепсі-етаіі, и вы 
сохранили это сообщение в тЬох-формате, тогда вы можете указать этот тЬох-файл команде 
діі: ат — в результате команда начнёт применять все патчи, которые найдёт. Если вы пользуетесь 
почтовым клиентом, способным сохранять несколько электронных писем в один тЬох-файл, 
то можете сохранить всю серию патчей в один файл и затем использовать команду діі ат 
для применения всех патчей сразу. 

Однако, если кто-нибудь загрузил патч, созданный через 'Гогтаі: - ра1:сИ, в тикет-систему 
или что-либо подобное, вы можете сохранить файл локально и затем передать его команде діі 
ат, чтобы его наложить: 

$ діі: ат ОѲѲІ-ІітіІі-Іод-^ипсІііоп . ра1:сп 
Арріуіпд: асісі Іітіі іо Іод -Гипсііоп 



Как видите, патч был применён без ошибок и за вас автоматически создан новый коммит. 
Информация об авторе берётся из полей Ргот и 0а1:е письма, а сообщение коммита извлекается 
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из поля ЗиЬзесІ: и тела (до начала самого патча) электронного письма. Например, если 
применить патч из тЬох-файла приведённого выше примера, то созданный для него коммит 
будет выглядеть следующим образом: 

$ діі Іод - -ргеІІу^-ГиІІег -1 

соттіі 6с5е70Ь984а60ЬЗсеса , 395есІсІ5Ь48а7575Ь-г58е0 
АиГпог: .Зеззіса 5ті1:п <}еззіса§ехатр1е . сот> 
АиІпогОаИе: 5ип Арг 6 10:17:23 2008 -0700 
Соттіі : Зсоіі Спасоп <зспасоп§дтаі1 . сот> 
СоттіЮаИе: Тпи Арг 9 09:19:06 2009 -0700 

асісі Іііліі Ьо Іод ■рипсіііоп 

Ьітіі Іод 'Гипс1:іопа1і1:у 1:о іпе ^ігзі: 20 

В поле Соттіі: указан человек, применивший патч, а в СоттіЮаІе — время его применения. 
Информация Аи 1: И о г определяет человека, создавшего патч изначально, и время его создания. 

Однако возможна ситуация, когда патч не наложиться без ошибок. Возможно ваша основная 
ветка слишком далеко ушла вперёд относительно той, на которой патч был основан, или этот 
патч зависит от другого патча, который вы ещё не применили. В этом случае выполнение 
команды діі: ат будет приостановлено, а у вас спросят, что вы хотите сделать: 



$ діі ат ѲѲѲІ-зееіпд-і^-Ііпіз-пеІрз-Ііпе-дет.раісп 




Арріуіпд: зееіпд ІТ іЫ5 пеірз іпе дет 




еггог: раГсп -Гаііесі: Іісдіі: . детзрес : 1 




еггог: іісдіі: . детзрес : ра1:сп сіоез поі: арріу 




Раісп гаііесі аі 0001. 




Ипеп уои паѵе гезоіѵесі 1:піз ргоЫет гип "діі ат - -гезоіѵесі" . 




11" уои моиісі рге'Гег іо зкір 1:пі5 ра1:сп, іпзіеасі гип "діі ат - 


-зкір" . 


То гезіоге 1:пе огідіпаі Ьгапсп апсі з1:ор ра1:спіпд гип "діі ат 


--аЬогЬ" . 



Эта команда выставляет отметки о конфликтах в каждый файл, с которым возникают 
проблемы, точно так же, как это происходит при операции слияния или перемещения с конфликтами. 
И разрешается данная ситуация тем же способом — отредактируйте файл, чтобы разрешить 
конфликт, добавьте новый файл в индекс, а затем выполните команду діі: ат - - гезоіѵесі, 
чтобы перейти к следующему патчу: 

$ (исправление файла) 
$ діі асісі Ііісдіі: . детзрес 
$ діі ат --гезоіѵесі 

Арріуіпд: зееіпд і^Г іпіз пеірз Іпе дет 



Если вы хотите, чтобы СіГ постарался разрешить конфликт более умно, воспользуйтесь 
опцией - 3, при которой СіГ попытается выполнить трёхходовую операцию слияния. Эта опция 
не включена по умолчанию, так как она не работает в случае, если коммита, на котором был 
основан патч, нет в вашем репозитории. Если этот коммит всё же у вас есть — в случае, 
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когда патч был основан на публичном коммите — то опция - 3 как правило гораздо умнее 
в наложении конфликтных патчей: 

$ діі ат -3 Ѳ001-зееіпд-іт"-1:Иіз-пе1рз-1:Ііе-дет.ра1:сИ 
Арріуіпд: зееіпд іг' іПіз Неірз Іпе дет 
еггог: раГсИ ^аііесі : Іісдіі: . детзрес : 1 
еггог: іісдіі: . детзрес : раісЬ сіоез поі: арріу 
ІІзіпд іпсіех іггГо Со гесопзСгис!: а Ьазе 1:гее... 
Раіііпд Ьаск Іо раісИіпд Ьазе апсі 3-иау тегде... 
N0 сИапдез -- Раісіі аігеасіу аррііесі. 



В этом случае я пытался применить патч, который я уже применил. Без опции - 3 это 
привело бы к конфликту. 

При применении серии патчей из тЬох-файла, вы также можете запустить команду ат в 
интерактивном режиме — в этом случае команда останавливается на каждом найденном патче 
и спрашивает вас, хотите ли вы его применить: 

$ діі ат -3 -і тЬох 
Соттіі Восіу із: 

зееіпд ±Т 1:Иіз Иеірз (іИе дет 



Арріу? [у]ез/[п]о/[е]сіі1:/[ѵ]іеи раісИ/[а]ссер(: аіі 




Это удобно, если у вас накопилось множество патчей, так как вы сможете сначала просмотреть 
патч, если вы забыли, что он из себя представляет, или отказаться применять патч, если он уже 
применён. 

После того как вы примените все патчи по интересующей вас теме и сделаете для них 
коммиты в своей ветке, вы можете принять решение — интегрировать ли их в свои стабильные 
ветки и если да, то каким образом. 

5.3.3 Проверка удалённых веток 

Если к вам поступили наработки от человека, использующего СіГ и имеющего свой собственный 
репозиторий, в который он и отправил свои изменения, а вам он прислал ссылку на свой 
репозиторий и имя удалённой ветки, в которой находятся изменения, то вы можете добавить 
его репозиторий в качестве удалённого и выполнить слияния локально. 

Например, если Джессика присылает вам письмо, в котором говорится, что у неё есть 
классная новая функция в ветке шЬу-сІіепІ: в её репозиторий, вы можете протестировать 
её, добавив её репозиторий в качестве удалённого для вашего проекта и выгрузив содержимое 
этой ветки в рабочий каталог: 

$ діі гетоСе асісі ]еззіса діі: : //діІИиЬ . сот/]еззіса/турго]есі . д±1 
$ діі т'еСсИ зеззіса 

$ діі спескоиі: -Ь гиЬусІіепІ: ]еззіса/гиЬу-с1іеп1: 
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Если она снова пришлёт вам письмо с другой веткой и с новой замечательной функцией, 
вы сможете сразу извлечь эти наработки и переключиться на эту ветку, так как её репозиторий 
уже прописан в ваших удалённых репозиториях. 

Этот метод наиболее удобен, если вы работаете с человеком постоянно. Если кто-то 
изредка представляет вам по одному патчу, то менее затратно по времени будет принимать 
их по е-таіі, чем заставлять всех иметь свои собственные репозиторий и постоянно добавлять 
и удалять удалённые репозиторий, чтобы получить пару патчей. Также вы скорее всего не 
захотите иметь у себя сотни удалённых репозиториев — для всех, кто предоставил вам один 
или два патча. Хотя сценарии и функции хостингов могут упростить эту ситуацию — всё 
зависит от того, как ведёте разработку вы и участники вашего проекта. 

Другим преимуществом данного подхода является тот факт, что вы получаете не только 
патчи, но и историю коммитов. Если вы даже обнаружите проблемы со слиянием, то вы по 
крайней мере будете знать, на каком коммите в вашей истории основана их работа. Правильное 
трёхходовое слияние в этом случае используется по умолчанию, что лучше, чем передать - 3 
и надеяться, что патч был сгенерирован на основе публичного коммита, к которому у вас есть 
доступ. 

Если вы не работаете с человеком постоянно, но всё же хотите принять его изменения 
таким способом, можете указать ІШЬ его удалённого репозитория команде діі: риіі. Так 
вы получите нужные изменения, а не будет сохранён в списке удалённых репозиториев: 

$ діі риіі діІ:://ді(:ІіиЬ.сот/опе1:ітедиу/рго]ес(:.ді1: 
Ргот діі: : //дНИиЬ . сот/опе1:ітедиу/ргсоес1: 

* ЬгапсИ НЕАй -> РЕТСН_НЕАР 

Мегде тасіе Ьу гесигзіѵе. 



5.3.4 Определение вносимых изменений 

Сейчас у вас есть тематическая ветка, содержащая наработки участников проекта. На 
этом этапе вы можете определить, что бы вы хотели с ними сделать. В этом разделе мы снова 
рассмотрим несколько команд, которые, как вы увидите, можно использовать для точного определения 
того, что вы собираетесь слить в свою основную ветку. 

Часто полезно просмотреть все коммиты, которые есть в этой ветке, но нет в вашей ветке 
тазііег. Исключить коммиты из ветки тазііег можно добавив опцию - - поі: перед именем 
ветки. Например, если участник вашего проекта прислал вам два патча, и вы создали ветку с 
именем соп1:гіЬ и применили эти патчи в ней, вы можете выполнить следующее: 

$ діі Іод соп1:гіЬ --поі: таз1:ег 

соттіі 5Ь6235Ьгі297351589егс4сІ73316г'Ѳа68с1484г'118 
АиІіМог: ЗсоЫ: СНасоп <зсНасоп§дтаі1.сот> 
Оаіе: Ргі Оси 24 09:53:59 2ѲѲ8 -07ѲѲ 

зееіпд І1" ЬНіз Иеірз іЬв дет 

соттіі 7482еѲсІ16сІѲ4Ьеа79сІѲсІЬа8988сс78сІт655г'16а0 
АиЬМог: Зсоп СИасоп <зсНасоп§дтаі1.сот> 
Оаіе: Моп Оси 22 19:38:36 2ѲѲ8 -07ѲѲ 
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Чтобы увидеть какие изменения вносит каждый коммит, если помните, можно передать 
опцию - р команде діі Іод — к каждому коммиту будет добавлен его аіЯ. 

Чтобы посмотреть полный сіій того, что добавится при слиянии вашей тематической ветки 
с другой веткой, вам может понадобиться использовать странный трюк, чтобы получить нужный 
результат. Вы, возможно, решите выполнить такую команду: 

$ діі сіітТ таз1:ег 



Эта команда выведет вам сИЯ, но результат может ввести вас в заблуждение. Если ваша 
ветка таз 1: е г была промотана вперёд с того момента, когда вы создали на её основе тематическую 
ветку, вы, наверняка, увидите странный результат. Это происходит по той причине, что Сіх 
напрямую сравнивает снимок состояния последнего коммита тематической ветки, на которой 
вы находитесь, и снимок последнего коммита ветки тазііег. Например, если вы добавили 
строку в файл в ветке таз 1; е г, прямое сравнение снимков покажет, что изменения в тематической 
ветке собираются эту строку удалить. 

Если тазііег является прямым предком вашей тематической ветки, то проблем нет. Но 
если две линии истории разошлись, то дііі будет выглядеть так, будто вы добавляете всё новое 
из вашей тематической ветки и удаляете всё уникальное в ветке тазііег. 

То, что вы действительно хотели бы видеть — это изменения, добавленные в тематической 
ветке, то есть те наработки, которые вы внесёте при слиянии этой ветки с веткой тазііег. 
Это выполняется путём сравнения последнего коммита в вашей тематической ветке с первым 
общим с веткой тазііег предком. 

Технически, вы можете сделать это, выделив общего предка явным образом и выполнив 
затем команду сИ'РТ: 



$ діі тегде-Ьазе сопігіЬ тазіег 




36с7сІЬа2с95е6ЫэЬ78сІг'а822519есг"ес6е1са649 




$ дхі сіітТ 36с7сІЬ 





Однако это не очень удобно, так что в Сіі есть отдельное сокращённое обозначение для 
выполнения того же самого — запись с тремя точками. В контексте команды сИ'Г'Г, вы можете 
поставить три точки после названия одной из веток, чтобы увидеть дельту между последним 
коммитом ветки, на которой вы находитесь, и их общим предком с другой веткой: 

$ діі сіітТ тазіег . . . сопітіЬ 



Эта команда покажет вам только те наработки в вашей текущей тематической ветке, которые 
были внесены после её ответвления от ветки таз 1: е г . Это очень удобный синтаксис и его надо 
запомнить. 
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5.3.5 Интегрирование чужих наработок 

Когда все наработки в вашей тематической ветке готовы к интегрированию в более стабильную 
ветку, встаёт вопрос — как это сделать? Более того — какой рабочий процесс в целом вы 
хотите использовать, занимаясь поддержкой своего проекта? Есть множество вариантов, так 
что рассмотрим некоторые из них. 

Процессы слияния Один из простых рабочих процессов заключается в слиянии наработок 
в ветку шазііег. В этом случае ваша ветка тазііег содержит основную стабильную версию 
кода. Если у вас в тематической ветке находится работа, которую вы уже доделали, или полученные 
от кого-то наработки, которые вы уже проверили, вы сливаете её в свою ветку таз 1: е г, удаляете 
тематическую ветку, а затем продолжаете работу. Если в вашем репозитории наработки находятся 
в двух ветках, названия которых г иЬу_с1іеп1: и рИр_с1іеп1: (Рисунок 5-19), и вы выполняете 
слияние сначала для ветки г и Ь у_с 1 і е п 1: , в потом для р И р_с 1 і е п 1: , то ваша история коммитов 
в итоге будет выглядеть, как показано на Рисунке 5-20. 



таБіег 




Т 

рИр_сІіепі 



Рисунок 5.19: История коммитов с несколькими тематическими ветками. 

Это, по всей видимости, наиболее простой рабочий процесс, но при работе с большими 
проектами здесь возникает ряд проблем. 

Если ваш проект более крупный, или вы работаете с большим количеством разработчиков, 
вы, вероятно, будете применять по крайней мере двухэтапный цикл слияний. При этом сценарии 
у вас есть две долго живущие ветки, тазііег и сіеѵеіор, и вы решили, что ветка тазііег 
обновляется только тогда, когда выходит очень стабильный релиз, а весь новый код включается 
в ветку сіеѵеіор. Изменения в обеих этих ветках регулярно отправляются в публичный репозиторий. 
Каждый раз, когда у вас появляется новая тематическая ветка для слияния (Рисунок 5-21), 
вы сначала сливаете её в сіеѵеіор (Рисунок 5-22); затем, когда вы выпускаете релиз, вы 
делаете перемотку (піві-иэгѵѵага) ветки шазііег на нужный стабильный коммит ветки сіе- 
ѵеіор (Рисунок 5-23). 
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(ЕМЕМЕ) 




Рисунок 5.20: История коммитов после слияния тематических веток. 



тазіег 



гіеѵеіор 




сі 
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гиЬу_сІіепі 



Рисунок 5.21: История коммитов до слияния тематической ветки. 



тазіег 



сіеѵеіор 




Рисунок 5.22: История коммитов после слияния тематической ветки. 



При таком подходе, клонируя ваш репозиторий, люди могут либо выгрузить ветку таз - 
1:е г , чтобы получить последний стабильный релиз и легко поддерживать этот код обновлённым, 
либо переключиться на ветку сіеѵеіор, которая включает в себя всё самое свежее. Вы также 
можете развить данный подход, создав ветку для интегрирования, в которой будет происходить 
слияние всех наработок. И когда код на этой ветке станет стабилен и пройдёт все тесты, вы 
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Рисунок 5.23: История коммитов после появления релиза. 



сольёте её в ветку сіеѵеіор; и если всё будет работать как надо в течение некоторого времени, 
вы выполните перемотку ветки тазііег. 

Рабочие процессы с крупными слияниями Проект СіІ имеет четыре долго живущие ветки: 
тазііег, пехі:, ри (ргоровеа ирааіез) для новых наработок и шаіпі: для ретроподдержки 
(Ьаскрогів). Когда участники проекта подготавливают свои наработки, они собираются в тематических 
ветках в репозитории мейнтейнера проекта примерно так, как мы уже описывали (смотри 
Рисунок 5-24). На этом этапе проводится оценка проделанной работы — всё ли работает, как 
положено, стабилен ли код, или ему требуется доработка. Если всё в порядке, то тематические 
ветки сливаются в ветку пехі:, которая отправляется на сервер, чтобы у каждого была возможность 
опробовать интегрированные воедино изменения из тематических веток. 



Рисунок 5.24: Управление группой параллельных тематических веток участников проекта. 

Если тематические ветки требуют доработки, они сливаются в ветку ри. Когда будет 
установлено, что тематические ветки полностью стабильны, они переливаются в тазііег, 
а ветки ри и пехі: перестраиваются на основе тематических веток, находившихся в пехі:, 
но ещё не дозревших до тазііег. Это означает, что шазііег практически всегда движется 
в прямом направлении, ветка пехі: перемещается (геЬаве) иногда, а ветка ри перемещается 
чаще всех (смотри Рисунок 5-25). 

Когда тематическая ветка была полностью слита в ветку таз 1:ег, она удаляется из репозитория. 
В проекте Сіі есть ещё ветка таіпі:, которая ответвлена от последнего релиза и предоставляет 
ЬаскрогІ-патчи, на случай если потребуется выпуск корректировочной версии. Таким образом, 
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Рисунок 5.25: Слияние тематических веток участников проекта в долго живущие интеграционные 
ветки. 

когда вы клонируете Сіі-репозиторий, вы получаете четыре ветки, переключаясь на которые 
вы можете оценить проект на разных стадиях разработки (в зависимости от того, насколько 
свежую версию вы хотите получить, или от того, каким образом вы хотите внести в проект 
свою работу); а мейнтейнер, в свою очередь, имеет структурированный рабочий процесс, который 
помогает ему изучать новые присланные патчи. 

Рабочие процессы с перемещениями и отбором лучшего Другие мейнтейнеры вместо слияния 
предпочитают выполнять перемещение или отбор лучших наработок участников проекта на 
верхушку своей ветки таз і. е г, чтобы иметь практически линейную историю разработки. Когда 
у вас есть наработки в тематической ветке, которые вы хотите интегрировать в проект, вы 
переходите на эту ветку и запускаете команду геЬазе, которая перемещает изменения на 
верхушку вашей текущей ветки тазііег (или сіеѵеіор, и т.п.). Если всё прошло хорошо, то 
можете выполнить перемотку ветки тазііег, получив тем самым линейную историю работы 
над проектом. 

Другой вариант перемещения сделанных наработок из одной ветки в другую — отбор 
лучшего (сЬеггу-ріск). Отбор лучшего в Сіі является чем-то наподобие перемещения для отдельных 
коммитов. Берётся патч, который был представлен в коммите, и делается попытка применить 
его на ветке, на которой вы сейчас находитесь. Это удобно в том случае, если у вас в тематической 
ветке находится несколько коммитов, а вы хотите включить в проект только один из них, или 
если у вас только один коммит в тематической ветке, но вы предпочитаете выполнять отбор 
лучшего вместо перемещения. Например, предположим, ваш проект выглядит так, как показано 
на Рисунке 5-26. 

Если вы хотите вытащить коммит е43а6 в ветку шазііег, выполните: 

$ діИ сМеггу-ріск е43а61=сіЗе94888сІ76779асі79-ГЬ568есЛ8Ѳе5г'ссІг' 
Ріпізпей опе сИеггу-ріск . 

[таз1:ег] : сгеа1:есі а0а41а9: "Моге ггіепсііу теззаде иНеп Іоскіпд 1:Ие іпсіех ■раііз." 
3 г"і1ез сНапдесІ, 17 іпзег1:іопз( + ) , 3 с!е1е1:іоп5( - ) 

Эта команда включит в ветку тазііег такие же изменения, которые были добавлены в 
е43а6, но вы получите новое значение 5НА-1 для этого коммита, так как у него будет другая 
дата применения. Теперь ваша история коммитов выглядит, как показано на Рисунке 5-27. 
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Рисунок 5.26: Пример истории коммитов перед отбором лучшего. 
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Рисунок 5.27: История коммитов после отбора лучшего коммита из тематической ветки. 



Теперь вы можете удалить свою тематическую ветку и отбросить коммиты, которые вы 
не захотели включить в проект. 



5.3.6 Отметка релизов 

Если вы решили выпустить релиз, вы, вероятно, захотите присвоить ему метку, так чтобы 
вы потом смогли восстановить этот релиз в любой момент. Процесс создания новой метки 
обсуждался в Главе 2. Если вы решили подписать вашу метку как мейнтейнер, то процедура 
будет выглядеть примерно следующим образом: 



$ діі іад -з ѵі.5 -т 'ту зідпесі 1.5 Іад' 
Ѵои пеесі а раззрНгазе 1о ипіоск (:Ие зесгеі: кеу 'Рог 
изег: "ЗсоЧ СИасоп <зсІіасоп§дтаі1.сот>" 
1024-ЬІС РЗА кеу, Ю Р721С45А, СГеаНеа 2009-02-09 



Если вы подписываете свои метки, у вас может возникнуть проблема с распространением 
открытого РСР-ключа, используемого для подписи ваших меток. Мейнтейнер проекта Сіі 
решил эту проблему, добавив свой публичный ключ в виде блоба (ЫоЬ) прямо в репозиторий и 
затем выставив метку, указывающую прямо на содержимое ключа. Чтобы сделать это, определите 
какой ключ вам нужен, выполнив д рд - - ІізЪ- кеуз: 



144 



5соП СЬасоп Рго Сіі 



Раздел 5.3 Сопровождение проекта 



$ дрд - -ІізС-кеуз 
/Іізегз/зсНасоп/ . дпирд/риЬгіпд . дрд 



риЬ 1024О/Р721С45А 2ѲѲ9-02-Ѳ9 [ехрігез: 2010-02-09] 
иісі 5со1:1: СИасоп <зсІіасоп§дтаі1.сот> 

зиЬ 2048д/45О02282 2009-02-09 [ехрігез: 2010-02-09] 



Затем вы можете напрямую импортировать ключ в базу данных Ск'а, экспортировав его и 
передав по конвейеру команде діі: ИазИ - оЪ] есіі, которая создастновый блоб с содержимым 
ключа и вернёт вам 5НА-1 этого блоба: 



$ дрд -а --ехрогі Р721С45А | діі ПазН-о^есС -ы --зСсІіп 
бБЭеГУЭУсШІбЗЗсЗУесУІасЗГЭЬагЭгебУУбЬэг 




Теперь, когда у вас в СіІ хранится ваш ключ, вы можете создать метку, напрямую указывающую 
на него, использовав значение 5НА-1, возвращённое командой НазН - оЪ] есіі: 

$ діі Сад -а таіпіаіпег-рдр-риЬ бБЭе-ГУЭУсЛЗІбЗЗсЗУесУІасЗ^ЭЬагЭтеБУУбЬэг 



Если вы запустите команду діі: ризИ - -1:ад5,то метка таіп1:аіпег-рдр-риЬ станет 
доступна каждому Если кто-нибудь захочет проверить какую-нибудь метку, он сможет напрямую 
импортировать ваш РСР-ключ, вытащив блоб прямо из базы данных и импортировав его в 
СРС: 

$ діі зпом таіпіаіпег-рдр-риЬ | дрд --ітрогі: 



Этот ключ может быть использован для проверки любых подписанных вами меток. Кроме 
того, если вы включите инструкции в сообщение метки, запуск діі згіом <метка> позволит 
конечному пользователю получить инструкции по проверке меток. 

5.3.7 Генерация номера сборки 

Так как коммитам в СіГ не присваиваются монотонно возрастающие номера наподобие 
'ѵ123' или чего-то аналогичного, то в случае, если вы хотите присвоить коммиту имя удобное 
для восприятия, запустите команду діі сІезсгіЬе для этого коммита. Сіі вернёт вам имя 
ближайшей метки с числом коммитов сделанных поверх этой метки и частичное значения 
5НА-1 описываемого коммита: 

$ діі сІезсгіЬе тазСег 
ѴІ.6.2-ГСІ-20-д8с5Ь85с 
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Таким образом при экспорте снимка состояния проекта или его сборки вы можете дать им 
имя понятное для людей. На самом деле, если вы собираете СіІ из исходного кода, сканированного 
из Сіі-репозитория, діі: - -ѵегзіоп вернёт вам что-то подобное. Если вы описываете коммит, 
которому вы напрямую присвоили метку, команда вернёт вам имя метки. 

Команду діі сІезсгіЬе хорошо использовать с аннотированными метками (метками, 
созданными при помощи опций - а или - 5), так что если вы используете діі сІезсгіЬе, то 
метки для релизов должны создаваться этим способом — в этом случае вы сможете удостовериться, 
что при описании коммиту было дано правильное имя. Вы также можете использовать эту 
строку в командах сНескоиІ: и 5 И ом для указания нужного коммита, однако в будущем она 
может перестать работать правильно в силу того, что в строке присутствует сокращённое значение 
5НА-1. Например, в ядре Ыгшх недавно перешли от 8 к 10 символам необходимым для обеспечения 
уникальности 5НА-1 объектов, и поэтому старые имена, сгенерированные командой діі: сіе - 
зсгіЬе, стали недействительными. 

5.3.8 Подготовка релиза 



Теперь хотелось бы выпустить релиз сборки. Вероятно, вам захочется сделать архив 
последнего состояния вашего кода для тех бедолаг, которые не используют Сіі. Для этого 
используется команда діі: агсИіѵе: 



$ діі агсИіѵе тазіег -- 


•ргеГ"іх= 1 ргсоесС/ ' 


| дгір > ~ді(: сіезсгіЬе тазСег ' . іаг . дг 


$ 1з * . Саг . дг 






ѵі . 6 . 2- гс1-20-д8с5Ь85с , 


, Гаг.дг 





Если кто-нибудь откроет этот ІагЬаІІ, он получит последний снимок состояния вашего 
проекта внутри каталога ргс^ есі:. Таким же способом вы можете создать гір-архив, указав 
команде діі. агсНіѵе опцию - -г"огта1:=2Ір: 

$ діі агсИіѵе тазЬег - -рге-Гіх= 1 ргоіесі/ ' - --Гогта1:=2ір > ~діі сІезсгіЬе тазіег~.2ір 



Теперь у вас есть тарбол и 2Ір-архив с релизом вашего проекта, которые вы можете загрузить 
на свой сайт или отправить людям по почте. 

5.3.9 Команда §Ьог(1о§ 

Пришло время написать письмо для списка рассылки, чтобы поделиться новостями проекта 
со всеми, кто им интересуется. При помощи команды діі зИог1:1од можно быстро получить 
что-то наподобие лога изменений (сЬап§е1о§), описывающего, что появилось нового в вашем 
проекте со времени последнего релиза или последнего письма в список рассылки. Лог изменений 
включает в себя все коммиты в указанном диапазоне; например, следующая команда вернёт 
вам сводку по всем коммитам, сделанным со времени прошлого релиза (если последний релиз 
имел метку ѵі.0.1): 
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$ діі згіогг.1од --по-тегдез тазЬег --пог. ѵі.0.1 
Сг,гіз ИапзИгаИгі (8) : 

Асісі зиррогі: -Тог аппо(а(:ѳсІ іадз г.о 6гіі::Тад 

АсІсІ раскесі- гетз аппог.аг.есІ іад зиррогі:. 

АсІсІ бгіг. : : Соттіг.#г.о_ра1:сгі 

ІІрсІа1:е ѵегзіоп апсі Ніз1:огу . іхг. 

Ретоѵе зг.гау "риг.з~ 

Маке 1з_г.гее ідпоге пііз 

Тот Ргезг.оп-Иегпег (4): 

гіх гіаііез іп Иіз1:огу 

сіупатіс ѵегзіоп те1:гіосІ 

Ѵегзіоп Ьитр іо 1.0.2 

Кедепегаг.есІ детзрес 'Тог ѵегзіоп 1.0.2 



Мы получили аккуратную сводку по всем коммитам, начиная с метки ѵі.0.1, сгруппированным 
по авторам. Вывод этой команды можно послать в свой список рассылки. 

5.4 Итоги 

Вы должны чувствовать себя достаточно свободно, внося свой вклад в проект под управлением 
Сіі, а также занимаясь поддержкой своего собственного проекта или интегрированием наработок 
других пользователей. Поздравляем тебя, опытный Сп-разработчик! В следующей главе вы 
познакомитесь с более мощными инструментами, а также получите советы по действию в 
сложных ситуациях, что сделает из вас настоящего мастера в СіС 
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К этому времени вы уже изучили большинство повседневных команд и способы организации 
рабочего процесса, необходимые для того, чтобы поддерживать С-іІ-репозиторий для управления 
версиями вашего исходного кода. Вы выполнили основные задания связанные с добавлением 
файлов под версионный контроль и записью сделанных изменений, и вы вооружились мощью 
подготовительной области (5Га§іп§ агеа), легковесного ветвления и слияния. 

Сейчас вы познакомитесь с множеством весьма сильных возможностей С-іГ. Вы совсем 
не обязательно будете использовать их каждый день, но, возможно, в какой-то момент они вам 
понадобятся. 

6.1 Выбор ревизии 

С-іІ позволяет вам указывать конкретные коммиты или их последовательности несколькими 
способами. Они не всегда очевидны, но иногда их полезно знать. 

6.1.1 Одиночные ревизии 

Вы можете просто сослаться на коммит по его 5НА-1 хешу, но также существуют более 
понятные для человека способы ссылаться на коммиты. В этом разделе кратко описаны различные 
способы обратиться к одному определённому коммиту. 

6.1.2 Сокращенный 8НА 

Сіі достаточно умён для того, чтобы понять какой коммит вы имеете в виду по первым 
нескольким символам (частичному хешу), конечно, если их не меньше четырёх и они однозначны, 
то есть если хеш только одного объекта в вашем репозитории начинается с этих символов. 

Например, предположим, что вы хотите посмотреть содержимое какого-то конкретного 
коммита. Вы выполняете команду діі Іод и находите этот коммит (например тот, в котором 
вы добавили какую-то функциональность): 

$ діи Іод 

соттіі 734713Ьс047сІ87Ьт7еас9674765ае793478с5ѲсІЗ 
АиЬМог: ЗсоЫ; СИасоп <зсИасоп§дтаі1.сош> 
Оаіе: Ргі Зап 2 18:32:33 2ѲѲ9 -08ѲѲ 
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■Гіхесі ге-Гз ИапсІІіпд, асісіесі дс аи1:о, ирсіаііесі Г.ез1:5 

соттіі сіэгіЭУѲаасІ^ѲЗЬЗс-ГѲеУІЬессІааЬЗІДУЬаУІссІеІ" 
Мегде: 1сѲѲ2сісі . . . 35сгЪ2Ь... 
АиІіМог: 5СОГ.Г. СИасоп <зсНасоп§дтаі1.сот> 
ЭаНе: ТИи Оес 11 15:08:43 2ѲѲ8 -08ѲѲ 

Мегде соттіг. ' рПесІсіегз/гсіосз ' 

соттіі 1сѲѲ2сШЬ536е7479т'е34593е72е6с6с1819е53Ь 
Аиг.Ног: ЗсоЫ: СИасоп <зсИасоп§дтаі1.сот> 
Оаіе: ТИи Оес 11 14:58:32 2ѲѲ8 -08ѲѲ 

асісіесі зоше Ыате апсі тегде зіигТ 

В нашем случае, выберем коммит 1с002сІсІ Если вы будете использовать діі 

5 И ОМ, чтобы посмотреть содержимое этого коммита следующие команды эквивалентны (предполагая, 
что сокращенные версии однозначны): 



$ діі зііом 1с0Ѳ2сІсІ4Ь536е7479г"е34593е72е6с6с1819е53Ь 
$ д±И зИом 1сѲѲ2сІсІ4Ь536е74791 = 
$ діі зііоід/ 1с0Ѳ2сІ 




СіІ может показать короткие, уникальные сокращения ваших 5НА-1 хешей. Если вы 
передадите опцию - -аЬЬгеѵ-сотшіІ: команде діі Іод, то её вывод будет использовать 
сокращённые значения, сохраняя их уникальными; по умолчанию будут использоваться семь 
символов, но при необходимости длина будет увеличена для сохранения однозначности хешей: 

$ діі Іод - -аЬЬгеѵ-соттіІ: - -рге1:1:у=опе1іпе 
са82а6сІ сНапдесІ іЬе ѵегзіоп питЬег 
085ЬЬЗЬ гетоѵесі иппесеззагу Ьезі: сосіе 
аНЬе'Гв ■ГІГЗІ: соттіі 




В общем случае, восемь-десять символов более чем достаточно для уникальности внутри 
проекта. В одном из самых больших проектов на Сіі, ядре Ьігшх только начинает появляться 
необходимость использовать 12 символов из 40 возможных для сохранения уникальности. 

6.1.3 Небольшое замечание о 8НА-1 

Многие люди интересуются, что произойдет, если они в какой-то момент, по некоторой 
случайности, получат два объекта в репозитории, которые будут иметь два одинаковых значения 
5НА-1 хеша. Что тогда? 

Если вы вдруг закоммитите объект, 5НА-1 хеш которого такой же, как у некоторого предыдущего 
объекта в вашем репозитории, СіГ обнаружит предыдущий объект в вашей базе данных СіГ, и 
посчитает, что он был уже записан. Если вы в какой-то момент попытаетесь получить этот 
объект опять, вы всегда будете получать данные первого объекта. 
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Однако, вы должны осознавать то, как смехотворно маловероятен этот сценарий. Длина 
5НА-1 составляет 20 байт или 160 бит. Количество случайно хешированных объектов, необходимое 
для того, чтобы получить 50% вероятность одиночного совпадения составляет порядка 2 80 
(формула для определения вероятности совпадения: р = (п(п-1)/2) * (1/2 '160))). 
2 80 это 1.2 х 10 24 или один миллион миллиарда миллиардов. Это в 1200 раз больше количества 
песчинок на земле. 

Вот пример для того, чтобы вы поняли, что необходимо, чтобы получить 5НА-1 коллизию. 
Если бы все 6.5 миллиардов людей на Земле программировали, и каждую секунду каждый 
из них производил количество кода, эквивалентное всей истории ядра Ышх (1 миллион СіГ 
объектов) и отправлял его в один огромный СіІ-репозиторий, то потребовалось бы 5 лет для 
того, чтобы заполнить репозиторий достаточно для того, чтобы получить 50% вероятность 
единичной 5НА-1 коллизии. Более вероятно, что каждый член вашей команды программистов 
будет атакован и убит волками в несвязанных друг с другом случаях в одну и ту же ночь. 

6.1.4 Ссылки на ветки 

Для самого прямого метода указать коммит необходимо, чтобы этот коммит имел ветку 
ссылающуюся на него. Тогда, вы можете использовать имя ветки в любой команде Сіі, которая 
ожидает коммит или значение 5НА-1. Например, если вы хотите посмотреть последний коммит 
в ветке, следующие команды эквивалентны, предполагая, что ветка 1:оріс1 ссылается на 
са82а6сІ: 

$ дІИ ЗІ10М Са82а6с1г'г'817ес66т44342007202690а93763949 
$ діі бііоіл/ Ііорісі 

Чтобы посмотреть на какой именно 5НА указывает ветка, или понять для какого-то из 
приведённых примеров к каким 5НА он сводится, можно использовать служебную (рштЪіп§) 
утилиту Сіі, которая называется геѵ- рагзе. Вы можете заглянуть в Главу 9 для получения 
большей информации о служебных утилитах; в основном геѵ-рагзе нужна для выполнения 
низкоуровневых операций и не предназначена для использования в повседневной работе. Однако, 
она может пригодиться, если вам необходимо разобраться, что происходит на самом деле. 
Сейчас вы можете попробовать применить геѵ- рагзе к своей ветке. 



$ діі геѵ-рагзе Ііорісі 

са82а6СІгТ817ес66г'44342ѲѲ72Ѳ269Ѳа93763949 




6.1.5 Ке{Ьо§-сокращения 

Одна из вещей, которую СК делает в фоновом режиме, пока вы работаете, это запоминание 
ссылочного лога — лога того, где находились НЕАБ и ветки в течение последних нескольких 
месяцев. 

Ссылочный лог можно просмотреть с помощью діі: ге'Под: 



151 



Глава 6 Инструменты Сіі 



Зсоп СЬасоп Рго Сіі 



$ діі геПод 


734713Ь. . 


. НЕАО§{0}: 


СІ92197Ѳ. . 


. НЕА0§{1}: 


ІС002СІСІ . . 


. НЕА0§{2}: 


1С36188. . 


. НЕА0§{3}: 


95СІГ984. . 


. НЕА0§{4}: 


1С36188. . 


. НЕА0§{5}: 


7еѲ5сІа5. . 


. НЕА0§{6}: 



сотшіі:: ГіхесІ геГз ИапсІІіпд, асісіесі дс аиіо, ирсІаЬесІ 

тегде рМесІсіегз/гсіосз : Мегде тасіе Ьу гесигзіѵе. 

соттіі: : асісіесі зоте Ыате апсі тегде зіиГГ 

геЬазе -і (зриазИ): ирсіаііпд НЕАО 

соттіі:: # ТГііз із а сотЬіпа1:іоп оГ іио соттИз. 

геЬазе -і (зриазИ): ирсіаііпд НЕАО 

геЬазе -і (ріск): ирсіаііпд НЕАР 



Каждый раз, когда верхушка ветки обновляется по какой-либо причине, СіГ сохраняет эту 
информацию в эту временную историю. И вы можете использовать и эти данные, чтобы задать 
прошлый коммит. Если вы хотите посмотреть какое значение НЕАБ имел пять шагов назад 
для своего репозитория, вы можете использовать ссылку вида @{п}, как показано в выводе 
команды ге'Под: 



$ діі зГюи НЕА0§{5} 



Также вы можете использовать эту команду, чтобы увидеть, где ветка была некоторое 
время назад. Например, чтобы увидеть, где была ветка тазііег вчера, наберите 



$ діі зИом шаз1:ег§{уез1:егсіау} 




Эта команда покажет, где верхушка ветки находилась вчера. Такой подход работает только 
для данных, которые всё ещё находятся в ссылочном логе. Так что вы не сможете использовать 
его для коммитов с давностью в несколько месяцев. 

Чтобы просмотреть информацию ссылочного лога в таком же формате как вывод діі 
Іод, можно выполнить діі: Іод -д: 



$ діі Іод -д тазГег 

соттіі 734713Ьс047сІ87ЬГ7еас9674765ае793478с50СІЗ 

КеПод: таз1:ег§{0} (Зсоп СИасоп <зсИасоп§дтаі1.сот>) 

КеПод теззаде: соттіі: ГіхесІ ге-Гз НапсІІіпд, асі сіесі дс аи1:о, ирсіа1:есі 

Аи1:Мог: ЗсоЧ СИасоп <зсИасоп§дтаі1.сот> 

Оаіе: Ргі 2 18:32:33 2009 -0800 

Гіхесі ге-Гз Иапсіііпд, асісіесі дс аи1:о, ирсіаііесі 1:ез1:з 

соттіі сІ921970аасІГ03ЬЗсГ0е71ЬессІааЬ3147Ьа71ссіеГ 

КеГІод: таз1:ег§{1} (ЗсоИ СИасоп <зсНасоп§дтаі1.сот>) 

КеПод теззаде: тегде рИесІсІегз/гсІосз : Мегде тасіе Ьу гесигзіѵе. 

АиІіИог: ЗсоИ СНасоп <зсИасоп§дтаі1.сот> 

Оаіе: ТИи Оес 11 15:08:43 2008 -0800 

Мегде соттіі: 1 рИесІсіегз/гсіосз 1 
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Важно отметить, что информация в ссылочном логе строго локальная — это лог того, 
чем вы занимались со своим репозиторием. Ссылки не будут теми же самыми в чьей-то чужой 
копии репозитория; и после того как вы только что склонировали репозиторий, ссылочный лог 
будет пустым, так как вы ещё ничего не делали со своим репозиторием. Команда діі: зНои 
НЕА0@{2 . топіігіз . адо} сработает только если вы склонировали свой проект как минимум 
два месяца назад. Если вы склонировали его пять минут назад, то вы ничего не получите. 

6.1.6 Ссылки на предков 

Ещё один основной способ указать коммит — указать коммит через его предков. Если 
поставить " в конце ссылки, для С-іГ это будет означать родителя этого коммита. Допустим 
история вашего проекта выглядит следующим образом: 

$ діі Іод - -ргеііу^-рогтаі: : '%Ь %з ' --дгарН 

* 734713Ь ■ріхесі ге'Рз ПапсЛіпд, асісіесі дс аиіо, ирсіаііесі Ьезіз 

* Й92197Ѳ Мегде соттіі: ' рИесІсіегз/гсіосз ' 

|\ 

| * 35сРЬ2Ь 5оте гсіос сііапдез 

* | 1сѲѲ2сІсІ асісіесі зоте Ыате апсі тегде зСи'Г'Г 

I/ 

* ІС36188 ідпоге *.дет 

* 9Ь29157 асісі орепЗ_сІе1:асН Со детзрес -Гііе Іізі 



В этом случае вы можете посмотреть предыдущий коммит указав НЕАО~, что означает 
«родитель НЕАБ»: 

$ діі зііои НЕАО л 

соттіі а , 92197ѲаааТ03ЬЗст'Ѳе71ЬессІааЬ3147Ьа71са'ег' 
Мегде: ісѲѲ2сісі... 35сгЪ2Ь... 
АиСИог: ЗсоЫ: СНасоп <зсИасоп§дтаі1.сот> 
Оаіе: ТИи Оес 11 15:08:43 2ѲѲ8 -08ѲѲ 



Мегде соттіі: 1 рИесісіегз/гсіосз 1 




Вы также можете указать некоторое число после Например, СІ92197Ѳ~2 означает 
«второй родитель коммита СІ921970». Такой синтаксис полезен только для коммитов-слияний, 
которые имеют больше, чем одного родителя. Первый родитель это ветка, на которой вы 
находились во время слияния, а второй — коммит на ветке, которая была слита: 

$ дІИ ЗІ10М СІ92197ѲЛ 

соттіі 1сѲѲ2а'а , 4Ь536е7479т'е34593е72е6с6с1819е53Ь 
АиСНог: ЗсоЫ: СИасоп <зсИасоп§дтаі1.сош> 
Оаіе: ТИи Оес 11 14:58:32 2ѲѲ8 -Ѳ8ѲѲ 

асісіесі зоте Ыате апсі тегде з(:и-р-р 

$ діі 5І10М СІ921970Л2 
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соттіі 35ст'Ь2Ь795а55793а , 7сс56а6СС2060Ь4ЬЬ732548 
Аиг.Мог: Раиі Несісіегіу <раи1+ді1:§тз г . огд> 
Оаіе: ЫеЬ Оес 10 22:22:03 2008 +0000 



5оте гсіос сИапдез 




Другое основное обозначение для указания на предков это ~. Это тоже ссылка на первого 
родителя, поэтому НЕАЭ- и НЕАО~ эквивалентны. Различия становятся очевидными, только 
когда вы указываете число. НЕАО-2 означает первого родителя первого родителя НЕАБ или 
прародителя — это переход по первым родителям указанное количество раз. Например, для 
показанной выше истории, НЕАЭ-З будет 

$ діі ЗІ10И НЕАО-3 

соттіі 1с3618887аг'Ь5г'ЬсЬеа25Ь7с013г'4е2114448Ь8сІ 
АиІіИог: Тот Ргезіоп-Ыегпег <1:от§тозотЬо . сот> 
Оаіе: Ргі ІЧоѵ 7 13:47:59 2008 -0500 

ідпоге *.дет 

То же самое можно записать как Н ЕАИ , что опять же означает первого родителя первого 
родителя первого родителя: 

$ діі зііои НЕАОЛЛЛ 

соттіі 1с3618887а1 = Ь51 = ЬсЬеа25Ь7с013Г4е2114448Ь8сІ 
АиЬМог: Тот РгезЬоп-Мегпег <1:от§тозотЬо . сот> 
Оаіе: Ргі Моѵ 7 13:47:59 2008 -0500 

ідпоге *.дет 



Кроме того, можно комбинировать эти обозначения. Например, можно получить второго 
родителя для предыдущей ссылки (мы предполагаем, что это коммит-слияние) написав НЕАЭ-З * 2, 
ну и так далее. 

6.1.7 Диапазон коммитов 

Теперь, когда вы умеете задавать отдельные коммиты, разберёмся как указать диапазон 
коммитов. Это особенно полезно при управлении ветками — если у вас много веток, вы можете 
использовать обозначения диапазонов, чтобы ответить на вопросы типа «Какие в этой ветке 
есть коммиты, которые не были слиты в основную ветку?» 

Две точки Наиболее распространённый способ задать диапазон коммитов — это запись с 
двумя точками. По существу, таким образом вы просите СіГ взять набор коммитов достижимых 
из одного коммита, но не достижимых из другого. Например, пускай ваша история коммитов 
выглядит так как показано на Рисунке 6-1. 

Допустим, вы хотите посмотреть что в вашей ветке ехрегітепг. ещё не было слито в 
ветку тазг-вг. Можно попросить Сіі показать вам лог только таких коммитов с помощью 
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тамег 



ехрегітеп( 



Рисунок 6.1: Пример истории для выбора набора коммитов. 

тазііег . . ехрегітепі: — эта запись означает «все коммиты достижимые из ехрегітепі, 
которые недостижимы из тазіег». Для краткости и большей понятности в примерах мы будем 
использовать буквы для обозначения коммитов на диаграмме вместо настоящего вывода лога 
в том порядке в каком они будут отображены: 

$ діі Іод таз1:ег . . ехрегітепі: 
С 

С другой стороны, если вы хотите получить обратное — все коммиты в таз г , которых 
нетв ехрегітепі:, можно переставить имена веток. Запись ехрегішепі: . . таз г_е г покажет 
всё, что есть в тазііег, но недостижимо из ехрегітепі:: 

$ діі Іод ехрегітепі: . . таз1:ег 

Р 

Е 

Такое полезно если вы хотите, чтобы ветка ехрегітепі: была обновлённой, и хотите 
посмотреть, что вы собираете в неё слить. Ещё один частый случай использования этого 
синтаксиса — посмотреть, что вы собираетесь отправить на удалённый сервер: 

$ діі Іод огідіп/таз(:ег . . НЕАй 

Эта команда покажет вам все коммиты в текущей ветке, которых нет в ветке тазііег 
на сервере огідіп. Если бы вы выполнили діі: ризИ, при условии, что текущая ветка 
отслеживает огідіп/шазііег, то коммиты, которые перечислены в выводе д і 1: Іод о г і - 
діп/тазііег . . НЕАЭ это те коммиты, которые были бы отправлены на сервер. Кроме того, 
можно опустить одну из сторон в такой записи — СіІ подставит туда НЕАБ. Например, вы 
можете получить такой же результат как и в предыдущем примере, набрав діі: Іод огі- 
діп/таз1:ег . . — Сіі подставит НЕАБ сам если одна из сторон отсутствует. 

Множество вершин Запись с двумя точками полезна как сокращение, но, возможно, вы 
захотите указать больше двух веток, чтобы указать нужную ревизию. Например, чтобы посмотреть, 
какие коммиты находятся в одной из нескольких веток, но не в текущей. СіІ позволяет сделать 
это с помощью использования либо символа * , либо - -поі. перед любыми ссылками, коммиты 
достижимые из которых вы не хотите видеть. Таким образом, следующие три команды эквивалентны: 
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$ діі Іод геГА. . геГВ 
$ діі Іод Л ге-ГА геГВ 
$ діі Іод геГВ --поі геГА 

Это удобно, потому что с помощью такого синтаксиса можно указать более двух ссылок в 
своём запросе, чего вы не сможете сделать с помощью двух точек. Например, если вы хотите 
увидеть все коммиты достижимые из гегА или геТВ, но не из гег'С, можно набрать одну из 
таких команд: 

$ діі Іод ге-ГА ге'ГВ Л геГС 

$ дхі Іод геТА геТВ --поі: геТС 



Всё это делает систему выбора ревизий очень мощной, что должно помочь вам определять, 
что содержится в ваших ветках. 

Три точки Последняя основная запись для выбора диапазона коммитов — это запись с тремя 
точками, которая означает те коммиты, которые достижимы по одной из двух ссылок, но не по 
обеим одновременно. Вернёмся к примеру истории коммитов на Рисунке 6-1. Если вы хотите 
увидеть, что находится в тазііег или ехрегішепі:, но не в обоих сразу, выполните 

$ діі Іод таз1:ег . . . ехрегітепі: 

Р 

Е 

С 



Повторимся, что это даст вам стандартный Іод-вывод, но покажет только информацию 
об этих четырёх коммитах упорядоченных по дате коммита как и обычно. 

В этом случае вместе с командой Іод обычно используют параметр - -Іег^-гідНІ:, 
который показывает, на какой стороне диапазона находится каждый коммит. Это помогает 
сделать данные полезнее: 

$ діі Іод --ІеГІ-гідІіІ: таз1:ег . . . ехрегітепі: 

< Р 

< Е 

> О 

> С 



С помощью этих инструментов, вы можете намного легче объяснить СіГ, какой коммит 
или коммиты вы хотите изучить. 
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6.2 Интерактивное индексирование 

Вместе с СіІ поставляется пара сценариев (зсгірі), облегчающих выполнение некоторых 
задач в командной строке. Сейчас мы посмотрим на несколько интерактивных команд, которые 
помогут вам легко смастерить свои коммиты так, чтобы включить в них только определённые 
части файлов. Эти инструменты сильно помогают в случае, когда вы поменяли кучу файлов, а 
потом решили, что хотите, чтобы эти изменения были в нескольких сфокусированных коммитах, 
а не в одном большом путанном коммите. Так вы сможете убедиться, что ваши коммиты 
это логически разделённые наборы изменений, которые будет легко просматривать другим 
разработчикам работающими с вами. Если вы выполните діі. асісі с опцией -і или -- 
Іп1:егас1:іѵе, С-іг перейдёт в режим интерактивной оболочки, и покажет что-то похожее на 
это: 



$ діі асісі -і 






5Г.адесІ 


ипзііадеа' раіИ 




1: ипсНапдесІ 


+Ѳ/-1 ТСЮО 




2: ипсНапдесІ 


іпсіех. Нг.т1 




3: ипсИапдесІ 


+5/-1 ІіЬ/зітрІедіІ: 


. гЬ 


*** Соттапсіз *** 






1: зСаИиз 2: 


ирсіа1:е 3: геѵегГ. 


4: асісі ипг.гаскесі 


5: раісИ 6: 


йітТ 7: диіГ. 


8: Иеір 


(л/Наі пом> 







Как видите, эта команда показывает содержимое индекса, но в другом виде — по сути, 
ту же информацию вы получили бы при вызове діі зг.аг.115, но здесь она в более сжатом 
и информативном виде, діі асісі - і показывает проиндексированные изменения слева, а 
непроиндексированные — справа. 

Затем идёт раздел Соттапсіз (команды). Тут можно сделать многие вещи, включая добавление 
файлов в индекс, удаление файлов из индекса, индексирование файлов частями, добавление 
неотслеживаемых файлов и просмотр дельт (сіій) проиндексированных изменений. 



6.2.1 Добавление и удаление файлов из индекса 

Если набрать 2 или и в приглашении ѴіЬаі. поѵі>, сценарий спросит какие файлы вы 
хотите добавить в индекс: 



Шаі пом> 2 




5Г.адесІ 


ипзігадесі раіИ 


1: ипсНапдесІ 


+Ѳ/-1 ТСЮО 


2: ипсНапдесІ 


іпсіех . Нг.т1 


3: ипсНапдесІ 


+5/-1 ІіЬ/зітрІедіІ: . гЬ 


ирсІаИе» 





Чтобы проиндексировать файлы ТСШО и іпаех.ЬптіІ, нужно набрать их номера: 
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ІірсІаИе» 1,2 






зг.адес1 


ипзг.адесІ 


раіИ 


* 1: ипсНапдесі 


+Ѳ/-1 


ТСЮО 


* 2: ипсНапдесі 


+1/-1 


іпсіех. Ыті 


3: ипсНапдесІ 


+5/-1 


1іЬ/зітр1еді1: . гЬ 


ирсіаИе» 







Символ * рядом с каждым файлом означает, что файл выбран для индексирования. Если 
вы сейчас ничего не будете вводить, а нажмёте Епіег в приглашении ІІрсІа1:е», то С-іі возьмёт 



всё, что уже выбрано 


, и добавит в индекс: 






ирсіаіе» 








ирсіаііесі 2 раІИз 








*** Соттапсіз *** 








1: зСаНиз 2: 


ирсіа1:е 3: геѵегі: 


4: асісі ипіігаскесі 




5: раісИ 6: 


сіігТ 7: диіИ 


8: Иеір 




ѴІЬаі. пом> 1 








з1:адесі 


ипз1:адесі раіИ 






1: +Ѳ/-1 


по1:Ніпд ТОЭО 






2: 


по1:Ніпд іпсіех. ЬШІ 






3: ипсНапдесІ 


+5/-1 1іЬ/зітр1еді1: 


.гЬ 













Как видите, теперь файлы ТСЮО и іпаех.пптіі проиндексированы (5Га§есі), а файл зітріе- 
§іі.гЬ всё ещё нет. Если в этот момент вы хотите удалить файл ТСШО из индекса, используйте 
опцию 3 или г (геѵегі): 



*** Соттапсіз *** 










1: зіаИиз 2: 


ирсіа1:е 


3: геѵегі: 


4: 


асісі ип1:гаскесі 


5: раісИ 6: 


сіігТ 


7: диіі: 


8: 


Ііеір 


Шаі. пои> 3 










з1:адесі 


ипзііадесі 


раііі 






1: +Ѳ/-1 


по1:Ніпд 


ТОЭО 






2: 


по1:Ніпд 


іпсіех. Ыті 






3: ипсНапдесІ 


+5/-1 


ІіЬ/зітрІедіІ: 


. гЬ 




Кеѵегі:» 1 










з1:адесі 


ипз1:адесі 


раііі 






* 1: +Ѳ/-1 


по1:Ніпд 


ТОЭО 






2: 


по1:Ніпд 


іпсіех. Ыті 






3: ипсНапдесІ 


+5/-1 


ІіЬ/зітрІедіІ: 






Кеѵегі» [епГег] 










геѵегіесі опе раіИ 











Взглянув на статус снова, вы увидите, что файл ТСШО удалён из индекса: 



*** Соттапсіз *** 
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1: зг.аг.из 2: 


ирсіа1:е 


3: геѵегг. 


4: асісі ипг.гаскесі 


5: раісН 6: 




7 : диіг. 


8: Иеір 


ѴЛіаі поѵі> 1 








зГ.адесІ 


ипзг.адесі 


раг.1і 




1: ипсНапдесІ 


+Ѳ/-1 


ТОйО 




2: 


пог.Ніпд 


іпсіех . Нг.т1 




3: ипсНапдесІ 


+5/-1 


ІіЬ/зітрІедіІ: 


. гЬ 



Чтобы посмотреть дельту для проиндексированных изменений, используйте команду 6 
или СІ (аіЯ). Она покажет вам список проиндексированных файлов, и вы можете выбрать те, 
для которых хотите посмотреть дельту. Это почти то же, что указать діі сИ'Г'Г - - сасИесІ в 
командной строке: 



*** Соттапсіз *** 






1: зСаНиз 2: 


ирсіа1:е 3: геѵегі: 


4: асісі ип1:гаскесі 


5: раісіі 6: 


сіітТ 7: диіі: 


8: (іеір 


ѴІЬаі. поы> 6 






зГ.адесІ 


ипзііадеа' раіИ 




1: 


пог.Ніпд іпсіех. ЬШІ 




Кеѵіем сіі-р-р» 1 






біТТ --діі: а/іпсіех 


.Ыті Ь/іпсІех . Иіті 




ІПСІех 4СІѲ7108. .4335Г49 1Ѳ0644 




— а/іпсіех . Нг.т1 






+++ Ь/іпсІех.И1:т1 






і§ -16,7 +16,7 §§ 


Оаіе Ріпсіег 




<р ісІ="ои1:">. . .</р> 




-<с!іѵ ісІ="1 ; оо1:ег">соп1:ас1: : зиррогі@ді1:ИиЬ 


, сот</сііѵ> 


+<сііѵ ісІ="'ГооІег">сопІ:асІ: : етаі1.зиррог1:і( 


ЗІІІіиЬ . сот</сІіѵ> 


<зсгірі 1:уре="1:еx(:/^аѵазс^ір1:"> 





С помощью этих базовых команд, вы можете использовать интерактивный режим для діі. 
асісі, чтобы немного проще работать со своим индексом. 



6.2.2 Индексирование по частям 

Для СіГ также возможно индексировать определённые части файлов, а не всё сразу. Например, 
если вы сделали несколько изменений в файле 5ітр1е§іг.гЬ и хотите проиндексировать одно из 
них, а другое — нет, то сделать такое в Сіг очень легко. В строке приглашения интерактивного 
режима наберите 5 или р (раІсЬ). СіІ спросит, какие файлы вы хотите индексировать частями; 
затем для каждой части изменений в выбранных файлах, один за другим будут показываться 
куски дельт файла и вас будут спрашивать, хотите ли вы занести их в индекс: 

сіітТ --діг. а/ІіЬ/зітрІедіГ. . гЬ Ь/ІіЬ/зітрІедіІ: . гЬ 
іпсіех Йс15есс4. .57399еѲ 1ѲѲ644 
— а/1іЬ/зітр1едіі . гЬ 
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+++ Ь/ІіЬ/зітрІедіг. . гЬ 
і§ -22,7 +22,7 §§ сіазз Зітріебіг. 
епсі 

сіег 1од(г.гееізп = 'таз1:ег') 

соттапсі( "діі Іод -п 25 #{г.гееізп}" ) 
+ соттапа( "діИ Іод -п 30 #{г.гееізп}" ) 
епсі 



беТ Ыате(раг.п) 
5г.аде г.піз пипк [у, п, а, сі, /, і , ^, д, е, ?]? 




На этой стадии у вас много вариантов действий. Набрав ? вы получите список того, что 
вы можете сделать: 

5г.аде іпіз пипк [у, п, а, й, /, і , 3, д, е, ?]? ? 

у - зіаде іпіз пипк (добавить этот кусок в индекс) 

п - сіо пог. зг.аде т:Иіз пипк (не добавлять этот кусок в индекс) 

а - зг.аде г.піз апсі аіі г.пе гетаіпіпд пипкз іп г.пе тііе (добавить этот и все оставшиеся куски в этом файле в инд 
сі - сіо пот. зіаде Ьпіз пипк пог апу оТ ІІіе гетаіпіпд Иипкз іп ІИе ■Гііе (не добавлять в индекс ни этот, ни последѵ 
д - зеіесі: а Иипк іо до іо (выбрать кусок и перейти к нему) 

/ - зеагсп 'Тог а пипк таг.спіпд 1:пе діѵеп гедех (поиск куска по регулярному выражению) 

І - Іеаѵе 1:піз пипк ипсіесісіесі, зее пехг. ипсіесісіеа' Иипк (отложить решение для этого куска, перейти к следующему 
^ - Іеаѵе г.піз пипк ипсіесісіесі, зее пехі. пипк (отложить решение для этого куска, перейти к следующему куску) 
к - Іеаѵе г.піз пипк ипсіесісіесі, зее ргеѵіоиз ипсіесісіеа' пипк (отложить решение для этого куска, перейти к преды/ 
К - Іеаѵе г.піз пипк ипсіесісіесі, зее ргеѵіоиз пипк (отложить решение для этого куска, перейти к предыдущему кус\ 
з - зрііг. СИе сиггепі: пипк іпіо зтаііег пипкз (разбить текущий кусок на меньшие части) 
е - тапиаііу есііі: г.пе сиггепі пипк (отредактировать текущий кусок вручную) 
? - ргіпг. пеір (вывести справку) 



Как правило, вы будете использовать у или П для индексирования каждого куска, но 
индексирование всех кусков сразу в некоторых файлах или откладывание решения на потом 
также может оказаться полезным. Если вы добавите в индекс одну часть файла, а другую часть 
— нет, вывод статуса будет выглядеть так: 



ЫпаС 


поы> 1 






5г.адесІ 


ипзііадеа' раіп 


1: 


ипспапдей 


+Ѳ/-1 ТСЮО 


2: 


+1/-1 


пог.піпд іпсіех. ЬШІ 


3: 




+4/-Ѳ ІіЬ/зітрІедіг. . гЬ 



Статус файла 5Ітр1е§іі.гЪ выглядит любопытно. Он показывает, что часть строк в индексе, 
а часть — не в индексе. Мы частично проиндексировали этот файл. Теперь вы можете выйти из 
интерактивного сценария и выполнить діі сотшіі:, чтобы создать коммит из этих частично 
проиндексированных файлов. 

В заключение скажем, что нет необходимости входить в интерактивный режим діі асісі, 
чтобы выполнять индексирование частями — вы можете запустить тот же сценарий набрав 
діі асісі - р или діі: асісі - - ра1:сИ в командной строке. 
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6.3 Прятанье 

Часто возникает такая ситуация, что пока вы работаете над частью своего проекта, всё 
находится в беспорядочном состоянии, а вам нужно переключить ветки, чтобы немного поработать 
над чем-то другим. Проблема в том, что вы не хотите делать коммит с наполовину доделанной 
работой, только для того, чтобы позже можно было вернуться в это же состояние. Ответ на эту 
проблему — команда діі: зіазгі. 

Прятанье поглощает грязное состояние рабочего каталога, то есть изменённые отслеживаемые 
файлы и изменения в индексе, и сохраняет их в стек незавершённых изменений, которые вы 
потом в любое время можете снова применить. 

6.3.1 Прятанье своих трудов 

Чтобы продемонстрировать как это работает, предположим, что вы идёте к своему проекту 
и начинаете работать над парой файлов и, возможно, добавляете в индекс одно из изменений. 
Если вы выполните діі. 5І:а1:и5, вы увидите грязное состояние проекта: 

$ діі 5г.аг.из 

# Оп ЬгапсИ тазЬег 

# СИапдез іо Ье соттіг.1:есі : 

# (иве "діГ. гезеі НЕАй <1 = і1е>..." г.о ипзіаде) 

# 

# тосіі^іесі: іпсіех . ЬШІ 

# 

# СМапдесІ Ьиі поі ирсіаііесі : 

# (изе "діГ. асісі <т"і1е>..." Ьо ирсіа1:е ыЬаі. мііі Ье соттлЛІіес)) 

# 

# тосІгРіесІ: ІіЬ/зітрІедіІ: . гЬ 

# 




Теперь вы хотите поменять ветку, но не хотите делать коммит с тем, над чем вы ещё 
работаете; тогда вы прячете эти изменения. Чтобы создать новую «заначку», выполните діі 
зг.азгі: 

$ діі зіазИ 

ЗаѵесІ могкіпд сіігесіогу апсі іпсіех зг.аг.е \ 

"ИІР оп тазНег: 049СІѲ78 асісіесі СИе іпсіех гііе" 
НЕДР із пои аГ. Ѳ49СІ078 асісіесі Ипе іпсіех гііе 
(То гезіоге Г.пет іуре "діГ. зЬазп арріу") 



Ваш рабочий каталог чист: 



$ діі зг-аіиз 

# Оп Ьгапсп шазііег 

поііпіпд 1:о соттіі: (могкіпд сИгесіогу сіеап) 
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В данный момент, вы легко можете переключить ветки и поработать где-то ещё; ваши 
изменения сохранены в стеке. Чтобы посмотреть, что у вас есть припрятанного, используйте 
діі: зііазгі ІізЪ: 



$ діі зіазИ 1І5І 








зИазИ§{0}: ИІР оп 


тазіег : 


049СІ078 


асісіесі Ьпе іпгіех г'Ие 


зИазИ§{1}: ИІР оп 


тазіег : 


С264051. 


. . Кеѵегі "асісіесі г"і1е_зІ2е" 


зЬазИ@{2}: ИІР оп 


тазіег : 


21сІ8Ѳа5, 


. . асісіесі питЬег 1:о Іод 



В нашем случае, две «заначки» были сделаны ранее, так что у вас теперь три разных 
припрятанных работы. Вы можете снова применить ту, которую только что спрятали, с помощью 
команды показанной в справке в выводе первоначальной команды зіазгкдіі: зііазгі ар - 
ріу. Если вы хотите применить одну из старых заначек, можете сделать это указав её имя так: 
діі зііазгі арріу 5І:а5гі@{2}. Если не указывать ничего, СК будет подразумевать, что 
вы хотите применить последнюю спрятанную работу: 

$ діі зГазп арріу 

# Оп Ьгапсп шазііег 

# Спапдесі Ьи1: поі: ирсіаііеа': 

# (изе "діі. абб <-Гі1е>..." Со ирсіа1:е ипаі мііі Ье сотшШесІ) 

# 

# тосіі^іесі: іпйех . ЬШІ 

# тосіі^іесі: ІіЬ/зітрІедіі . гЬ 

# 




Как видите, СіІ восстановил изменения в файлах, которые вы отменили, когда использовали 
команду ЗІіазИ. В нашем случае, у вас был чистый рабочий каталог, когда вы восстанавливали 
спрятанные изменения, и к тому же вы делали это на той же ветке, на которой находились 
во время прятанья. Но наличие чистого рабочего каталога и применение на той же ветке 
не обязательны для діі зІіазИ арріу. Вы можете спрятать изменения на одной ветке, 
переключиться позже на другую ветку и попытаться восстановить изменения. У вас в рабочем 
каталоге также могут быть изменённые и недокоммиченные файлы во время применения спрятанного 
— СіІ выдаст вам конфликты слияния, если что-то уже не может быть применено чисто. 

Изменения в файлах были восстановлены, но файлы в индексе — нет. Чтобы добиться 
такого, необходимо выполнить команду діі зІіазИ арріу сопцией - -іпсіех, тогдакоманда 
попытается применить изменения в индексе. Если бы вы выполнили команду так, а не как 
раньше, то получили бы исходное состояние: 

$ діі зСазИ арріу --іпсіех 

# Оп ЬгапсИ шазііег 

# СМапдез Со Ье соттИСео 1 : 

# (изе "діС гезеі НЕАй <'Гі1е>..." іо ипзСаде) 

# 

# тосіітіеа': іпсіех . ЬШІ 

# 

# СЬапдеа 1 ЬиС поС ира'аСеа': 
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# (изе "діі асісі <т"і1е>..." Со ирсіа1:е ѵіЬаі мііі Ье соттШеа 1 ) 

# 

# тосіі^іесі: ІіЬ/зітрІедіі . гЬ 

# 

Всё что делает опция арріу это пытается применить спрятанную работу — то, что вы 
спрятали, всё ещё будет находиться в стеке. Чтобы удалить спрятанное, выполните діі 5 1:аз И 
сігор с именем «заначки», которую нужно удалить: 

$ діі зг.азН Іізі 

зг.азН§{0}: ИІР оп тазіег: Ѳ49СІѲ78 асі сіесі т:Ие іпсіех -Гііе 
з1:азМ§{1}: ЫІР оп тазіег: С264Ѳ51... Кеѵегі: "асісіесі -Гі1е_зі2е" 
з1:азп§{2}: ИІР оп тазг.ег: 21сІ8Ѳа5... ао'о'еа' питЬег Со Іод 
$ діі зіазп сігор зіазп@{Ѳ} 

Огорресі зИазп§{Ѳ} (ЗбДеЭІгЗггбвГѲЭѲѲЬсЗеебІЗГэтзевгааеаЧЗ) 

Также можно выполнить діі зііазгі рор, чтобы применить спрятанные изменения и 
сразу же удалить их из стека. 

6.3.2 Откат применения спрятанных изменений 

При некоторых сценариях использования, может понадобиться применить спрятанные 
изменения, поработать, а потом отменить изменения, внесённые командой зііазгі арріу. 
С-іг не предоставляет команды зііазгі ипарріу, но можно добиться того же эффекта получив 
сначала патч для спрятанных изменений, а потом применив его в перевёрнутом виде: 

$ діі зг.азН зНои -р зіазИ@{Ѳ} | діі арріу -К 



Снова, если вы не указываете параметр для віавп, СіІ подразумевает то, что было спрятано 
последним: 

$ діг. зіазИ зИои -р | діг. арріу -К 



Если хотите, сделайте псевдоним и добавьте в свой §іг команду зііазгі-ипарріу. Например, 

так: 

$ діі согтГід --дІоЬаІ аііаз . зСазИ-ипаррІу '!діі зСазИ зИои -р | дИ арріу -К' 

$ діі зіазИ 

$ #. . . могк иогк иогк 

$ діг. зіазИ-ипаррІу 
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6.3.3 Создание ветки из спрятанных изменений 

Если вы спрятали какие-то наработки и оставили их на время, а в это время продолжили 
работать на той же ветке, то у вас могут возникнуть трудности с восстановлением спрятанной 
работы. Если арріу попытается изменить файл, который вы редактировали после прятанья, 
то возникнет конфликт слияния, который надо будет разрешить. Если нужен более простой 
способ снова потестировать спрятанную работу, можно выполнить команду д і 1: 5 1: аз И ЬгапсИ, 
которая создаст вам новую ветку с началом из того коммита, на котором вы находились во время 
прятанья, восстановит в ней вашу работу и затем удалит спрятанное, если оно применилось 
успешно: 

$ діі зіазИ ЬгапсИ іезІісИапдез 
5иі1:сІіесІ Ьо а пей Ьгапсп 'ЧезЬсИапдез" 

# Оп ЬгапсИ 1:ез1:сИапдез 

# СМапдез 1:о Ье соттііііеа' : 

# (изе "діі гезеі НЕАй <т : і1е>..." іо ипзЬаде) 

# 

# тосіітіесі: іпсіех . НШ1 

# 

# СЬапдеб Ьиі. поХ. ирсіаііесі : 

# (изе "діі асісі <ті1е>..." Ьо ирсіа1:е мИаі мііі Ье сотті!:1:есІ) 

# 

# тосіі^іесі: ІіЬ/зітрІедіі . гЬ 

# 

Огорреа ге-Гз/з1:азИ§{0} (-ГОсІГсДсіБсІсЗЗгаІсееЗДабЗДІзгеІбвсДеГсЗЗбЭ) 




Это сокращение удобно для того, чтобы легко восстановить свою работу, а затем поработать 
над ней в новой ветке. 

6.4 Перезапись истории 

Неоднократно, во время работы с СіГ, вам может захотеться по какой-либо причине исправить 
свою историю коммитов. Одна из чудесных особенностей СіГ заключается в том, что он даёт 
возможность принять решение в самый последний момент. Вы можете решить какие файлы 
пойдут в какие коммиты перед тем как сделать коммит используя индекс, вы можете решить, 
что над чем-то ещё не стоило начинать работать и использовать команду ЗІіазИ. А также 
вы можете переписать уже сделанные коммиты так, как-будто они были сделаны как-то по- 
другому. В частности это может быть изменение порядка следования коммитов, изменение 
сообщений или изменение файлов в коммите, уплотнение и разделение коммитов, а также 
полное удаление некоторых коммитов — но только до того как вы поделитесь наработками 
с другими. 

В этом разделе вы узнаете как выполнять подобные полезные задачи и как сделать так, 
чтобы история коммитов выглядела так как вам хочется перед тем, как вы её опубликуете. 

6.4.1 Изменение последнего коммита 

Изменение последнего коммита это, вероятно, наиболее типичный случай переписывания 
истории, который вы будете делать. Как правило, вам от вашего последнего коммита понадобятся 



164 



5соп СЬасоп Рго Сіі 



Раздел 6.4 Перезапись истории 



две основные вещи: изменить сообщение коммита, или изменить только что записанный снимок 
состояния, добавив, изменив или удалив из него файлы. 

Если вы всего лишь хотите изменить сообщение последнего коммита — это очень просто: 

$ діі соттіі: --атепсі 



Выполнив это, вы попадёте в свой текстовый редактор, в котором будет находиться сообщение 
последнего коммита, готовое к тому, чтобы его отредактировали. Когда вы сохраните текст 
и закроете редактор, Сіт создаст новый коммит с вашим сообщением и сделает его новым 
последним коммитом. 

Если вы сделали коммит и затем хотите изменить снимок состояния в коммите, добавив 
или изменив файлы, допустим, потому что вы забыли добавить только что созданный файл, 
когда делали коммит, то процесс выглядит в основном так же. Вы добавляете в индекс изменения, 
которые хотите, редактируя файл и выполняя для него діі асісі или выполняя діі гш для 
отслеживаемого файла, и затем діі соттіі: - -атепсі возьмёт текущий индекс и сделает 
его снимком состояния нового коммита. 

Будьте осторожны используя этот приём, потому что діі: сотшіі: - -атепсі меняет 
5НА-1 коммита. Тут как с маленьким перемещением (геЬаке) — не правьте последний коммит, 
если вы его уже куда-то отправили. 

6.4.2 Изменение сообщений нескольких коммитов 

Чтобы изменить коммит, находящийся глубоко в истории, вам придётся перейти к использованию 
более сложных инструментов. В С-іГ нет специального инструмента для редактирования истории, 
но вы можете использовать г еЬазе для перемещения ряда коммитов на то же самое место, где 
они были изначально, а не куда-то в другое место. Используя инструмент для интерактивного 
перемещения, вы можете останавливаться на каждом коммите, который хотите изменить, и 
редактировать сообщение, добавлять файлы или делать что-то ещё. Интерактивное перемещение 
можно запустить добавив опцию -і к діі геЬазе. Необходимо указать насколько далекие 
в истории коммиты вы хотите переписать, сообщив команде на какой коммит выполняется 
перемещение. 

Например, если вы хотите изменить сообщения последних трёх коммитов, или сообщения 
для только некоторых коммитов в этой группе, вам надо передать в діі г еЬазе - і в качестве 
аргумента родителя последнего коммита, который вы хотите изменить, то есть НЕА0~2~ или 
НЕАЭ-З. Наверное проще запомнить ~3, потому что вы пытаетесь отредактировать три последних 
коммита, но имейте в виду, что на самом деле вы обозначили четвёртый сверху коммит — 
родительский коммит, для того, который хотите отредактировать: 

$ дИ геЬазе -і НЕАЭ-З 



Снова напомним, что эта команда для перемещения, то есть все коммиты в диапазоне 
НЕАЭ-З . . НЕАЭ будут переписаны, вне зависимости от того меняли ли вы в них сообщение 
или нет. Не трогайте те коммиты, которые вы уже отправили на центральный сервер — сделав 
так, вы запутаете других разработчиков дав им разные версии одних и тех же изменений. 
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Запуск этой команды выдаст вам в текстовом редакторе список коммитов, который будет 
выглядеть как-нибудь так: 

ріск т7т'Зт'6сІ сНапдеа! ту пате а Ьіі 

ріск 31Ѳ154е ирсіаііесі РЕАРМЕ гЪгтаіііпд апсі асісіесі Ыате 
ріск аБТЛаѲб асісіесі саЬ-т'Ие 

# КеЬазе 71ѲТѲТ8 . . абгЧаѲс! опПо 71&ТѲТ8 

# 

# Соттапсіз: 

# р, ріск = изе соттіі: 

# е, есШ: = изе соттіі:, Ьиі зГор -Тог атепсііпд 

# з, зриазН = изе соттіі:, Ьиі теісі іп1:о ргеѵіоиз соттИ 

# 

# Іг уои гетоѵе а Ііпе Иеге ТНАТ СОММІТ ИИ ВЕ Ю5Т. 

# Номеѵег, І1" уои гетоѵе еѵегу1:Иіпд, іЬе геЬазе іл/ііі Ье аЬогіесі. 

# 



Важно отметить, что эти коммиты выведены в обратном порядке по сравнению с тем, 
как вы их обычно видите используя команду Іод. Запустив Іод, вы получите что-то типа 
следующего: 

$ діі Іод --ргеИИу^огтаИ: 1 ^ %з" НЕА0-З..НЕА0 
а5-Г4а0сі асісіесі са1:--Гі1е 

310154е ирсІаГ:есІ КЕАЭМЕ тогтаііііпд апсі асісіесі Ыате 
-Г7-ГЗ-Г6СІ сИапдесі ту пате а ЫС 



Обратите внимание на обратный порядок. Интерактивное перемещение выдаёт сценарий, 
который будет выполнен. Он начнётся с коммита, который вы указали в командной строке 
(НЕАЭ-З), и воспроизведёт изменения сделанные каждым из этих коммитов сверху вниз. Наверху 
указан самый старый коммит, а не самый новый, потому что он будет воспроизведён первым. 

Вам надо отредактировать сценарий так, чтобы он останавливался на коммитах, которые 
вы хотите отредактировать. Чтобы сделать это, замените слово ріск на слово еаіі для каждого 
коммита, на котором сценарий должен остановиться. Например, чтобы изменить сообщение 
только для третьего коммита, отредактируйте файл так, чтобы он выглядел следующим образом: 

есііі: т7т'3т'6а' спапдесі ту пате а Ьіт: 

ріск 310154е ирсіаііесі РЕАРМЕ -Гогтаіііпд апсі асісіесі Ыате 
ріск а5-Г4аѲсі асісіесі саіі-тііе 



Когда вы сохраните и выйдете из редактора, СіІ откатит вас назад к последнему коммиту 
в списке и выкинет вас в командную строку выдав следующее сообщение: 

$ дИ геЬазе -і НЕАЭ-З 

5т:орресІ аі 7482еѲсІ... ирсІат:есІ іЬе детзрес іо Ііоре-Гиііу иогк ЬеНег 
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Ѵои сап атепсі г.пе соттіі: пои, мііп 

діг. соттіі --атепсі 
Опсе уои'ге 5аГ.і5г"іесІ мі1:п уоиг сПапдез, гип 

діг. геЬазе --сопГ.іпие 



В этой инструкции в точности сказано что надо сделать. Наберите 
$ діі соттіі: --атепсі 

Измените сообщение коммита и выйдите из редактора. Теперь выполните 
$ діі геЬазе --сопііпие 

Эта команда применит оставшиеся два коммита автоматически, и тогда всё. Если вы 
измените ріск на еаіг для большего количества строк, то вы повторите эти шаги для каждого 
коммита, где вы напишите есік. Каждый раз СіГ будет останавливаться, давая вам исправить 
коммит, а потом, когда вы закончите, будет продолжать. 

6.4.3 Переупорядочение коммитов 

Интерактивное перемещение можно также использовать для изменения порядка следования 
и для полного удаления коммитов. Если вы хотите удалить коммит «аааесі саі-йіе» и поменять 
порядок, в котором идут два других коммита, измените сценарий для геЬаве с такого 

ріск Т7ТЗТ66 сНапдесІ ту пате а Ьіг. 

ріск 31Ѳ154е ирсіаііесі РЕАРМЕ ■рогтаіііпд апсі асісіесі Ыате 
ріск а5-Г4аѲсі асісіесі саЬ-'ГИе 



на такой: 



ріск 31Ѳ154е ирс!ат:есІ РЕАРМЕ ■Гогтаіііпд апсі асісіесі Ыате 
ріск -Г7-ГЗ-Г6СІ сИапдесІ ту пате а ЬіГ. 




Когда вы сохраните и выйдите из редактора, СіГ откатит вашу ветку к родительскому для 
этих трёх коммиту, применит 310154е, затем "Г7"ГЗ"Г6сІ, а потом остановится. Вы фактически 
поменяли порядок следования коммитов и полностью удалили коммит «аааесі саі-йіе». 
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6.4.4 Уплотнение коммитов 

С помощью интерактивного перемещения также возможно взять несколько коммитов и 
сплющить их в один коммит. Сценарий выдаёт полезное сообщение с инструкциями для 
перемещения: 

# 

# Соттапсіз: 

# р, ріск = изе соттіг. 

# е, есШ: = изе соттіГ., Ьиі зіор Тог атепсііпд 

# з, зриазН = изе соттіГ., Ьиі теісі іпГ.о ргеѵіоиз соттіі: 

# 

# Іг уои гетоѵе а Ііпе Иеге ТНАТ СОММІТ ИИ ВЕ Ю5Т. 

# Номеѵег, ±Т уои гетоѵе еѵегу1:Иіпд, іЬе геЬазе іл/ііі Ье аЬогіесі. 

# 

Если вместо «ріск» или «еаіг» указать «здиавЬ», СіГ применит изменения и из этого коммита, 
и из предыдущего, а затем даст вам объединить сообщения для коммитов. Итак, чтобы сделать 
один коммит из трёх наших коммитов, надо сделать так, чтобы сценарий выглядел следующим 
образом: 

ріск Т7ТЗТ66 сИапдесІ ту пате а Ьіі 

здиазп 31Ѳ154е ирсіаіесі КЕАОМЕ -Гогта1:1:іпд апсі асісіегі Ыате 
здиазИ а5-Г4аѲсі асісіесі са1:--Гі1е 



Когда вы сохраните и выйдите из редактора, С-іІ применит все три изменения, а затем 
опять выдаст вам редактор для того, чтобы объединить сообщения трёх коммитов: 

# ТИіз із а сотЬіпаііоп от' 3 соттііз. 

# ТИе ■рігзг. соттИ'з теззаде із: 
сИапдесІ ту пате а Ьіт: 

# Тпіз із ЬЬе 2псІ соттіі: теззаде: 
ирсіаііесі КЕАОМЕ ■Гогтаіііпд апсі асісіесі Ыате 

# ТИіз із 1:Ме ЗгсІ соттіі: теззаде: 



асісіесі саГ.-ті1е 




Когда вы это сохраните, у вас будет один коммит, который вносит изменения такие же как 
три бывших коммита. 

6.4.5 Разбиение коммита 

Разбиение коммита — это отмена коммита, а затем индексирование изменений частями и 
добавление коммитов столько раз, сколько коммитов вы хотите получить. Например, предположим, 

168 



5соп СЬасоп Рго Сіі 



Раздел 6.4 Перезапись истории 



что вы хотите разбить средний из наших трёх коммитов. Вместо «ирааіесі КЕАБМЕ {огтаГ1:іп§ 
апсі асісіеа Ыате», вы хотите получить два отдельных коммита: «ирсіаіеа КЕАБМЕ {огта!йп§» 
в качестве первого и «аасіеа Ыате» в качестве второго. Вы можете сделать это в сценарии 
геЬазе - і поставив «еаіі» в инструкции для коммита, который хотите разбить: 

ріск Т7ТЗТ66 спапдесі ту пате а Ьіг. 

есііт: 310154е ирсіаііесі КЕАРМЕ -Гогтаіііпд апсі асісіесі Ыате 
ріск а5-Г4аѲсі асісіесі саГ.-'г'Ие 



Теперь, когда сценарий выбросит вас в командную строку, отмените этот коммит с помощью 
гезеі:, возьмите изменения, которые были сброшены и создайте из них несколько коммитов. 
Когда вы сохраните и выйдите из редактора, Сіі откатится к родителю первого коммита в 
списке, применит первый коммит (1 = 71 = 31 = 6с1), применит второй (310154е) и выбросит вас в 
консоль. Здесь вы можете сбросить этот коммит в смешанном режиме с помощью діі. г езеі: 
НЕАЭ * — это эффективно отменит этот коммит и оставит изменённые файлы непроиндексированными. 
Теперь вы можете добавлять файлы в индекс и делать коммиты, пока не получите несколько 
штук. Затем, когда закончите, выполните д і 1: геЬазе --сопіііпие: 

$ діі гезег. НЕАР Л 

$ діі асШ кеаоме 

$ діг. соттіі: -т 'ирсіаіесі КЕАРМЕ ^огтаШпд 1 

$ діі асісі ІіЬ/зітрІедіГ. . гЬ 

$ діі соттіі: -т 'асісіесі Ыате' 

$ діг. геЬазе --сопііпие 



Когда Сіг применит последний коммит (а51 = 4а0с1) в сценарии, история будет выглядеть 

так: 

$ діі Іод -4 --ргеССу=-гогтаг.:"?аі %з" 

1сѲѲ2сІсІ асісіесі са1:--Гі1е 

9Ь29157 асісіесі Ыате 

35с1=Ь2Ь ирсіаИесі КЕАЭМЕ -Гогтаіііпд 

•Г3сс40е сИапдесі ту пате а Ьіі 



Повторимся ещё раз, что эта операция меняет 5НА всех коммитов в списке, так что убедитесь, 
что ни один из коммитов в этом списке вы не успели уже отправить в общий репозиторий. 

6.4.6 Крайнее средство: Шіег-ЬгапсЬ 

Есть ещё один вариант переписывания истории, который можно использовать если надо 
переписать большое количество коммитов в автоматизируемой форме — например, везде поменять 
свой е-гдаіі адрес или удалить файл из каждого коммита — это команда г"І1г.ег - ЬгапсН. 
Она может переписать огромные периоды вашей истории, так что, возможно, вообще не стоит 
использовать её, если только ваш проект не успел ещё стать публичным и другие люди не 
успели ещё проделать работу на основе коммитов, которые вы собрались переписать. Однако, 
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она может быть весьма полезной. Мы посмотрим на некоторые типичные варианты использования 
команды так, чтобы вы получили представление о тех вещах, на которые она способна. 

Удаление файла изо всех коммитов Такое случается довольно часто. Кто-нибудь случайно 
добавляет в коммит огромный бинарный файл необдуманно выполнив д і 1: асі сі . , и вы хотите 
удалить его отовсюду. Или, может быть, вы нечаянно добавили в коммит файл содержащий 
пароль, а теперь хотите сделать код этого проекта открытым. ТІІ^ег - ЬгапсН — это тот 
инструмент, который вы наверняка захотите использовать, чтобы прочесать всю историю. Чтобы 
удалить файл с именем раазшогсіз.ш изо всей истории, используйте опцию - -Іігее-гііііег 
для ■рШег-ЬгапсН: 

$ діі т'Иг.ег-ЬгапсП - -г.гее-т'Шег 1 гт -Т раззиогсіз . ЬхЬ ' НЕАЭ 
Кеигііе бЬЭЬЗсгШеТсБбвбаЭсЬвЗвсЗГЗбавсЬбаОГсгЬсІ (21/21) 
Ке-Г ' ге-рз/Неасіз/тазіег ' иаз геигіііеп 



Опция - -Ігее-^ІІЪег выполняет указанную команду после выгрузки каждой версии 
проекта и затем заново делает коммит из результата. В нашем случае, мы удалили файл с 
именем раквшогав.Ш из каждого снимка состояния независимо от того существовал ли он там 
или нет. Если вы хотите удалить все случайно добавленные резервные копии сделанные вашим 
текстовым редактором, выполните что-то типа діі 1 = і11:ег - ЬгапсИ - -ігее-^іііег 
'гт -1= *-' НЕАЭ. 

Вы увидите как СіІ переписывает деревья и коммиты, а в конце переставляет указатель 
ветки. Как правило, хороший вариант — делать это в тестовой ветке, а затем жёстко сбрасывать 
ветку тавіег с помощью гезеі: - -гіагсі, когда вы поймёте, что результат это то, чего вы 
действительно добивались. Чтобы запустить гі11:ег - ЬгапсН для всех веток, можно передать 
команде параметр - - аіі. 

Сделать подкаталог новым корнем Предположим, вы импортировали репозиторий из другой 
системы управления версиями и в нём есть бессмысленные каталоги (Гшпк, Га§5, и др.). Если 
вы хотите сделать ішпк новым корнем проекта, команда г'л.Игег - ЬгапсН может помочь 
вам сделать и это: 

$ діі т'Иг.ег-ЬгапсН - -зиЬсІігесІогу-таІіег Ьгипк НЕАО 
Кемгііе 856т'ѲЬт"61е41а27326сс1ае8г'09г'е7Ѳ8с1679г'596г' (12/12) 
Кет' 1 гет'з/Неайз/тазЬег ' маз гемгіііеп 



Теперь всюду корневой каталог проекта будет в подкаталоге 1: г и п к. Сіг также автоматически 
удалит все коммиты, которые не затрагивают данный подкаталог. 

Глобальное именение е-таіі адреса Ещё один типичный случай это, когда вы забыли выполнить 
діі согтРід, чтобы задать своё имя и е-таіі адрес перед тем как начать работать. Или, 
возможно, вы хотите открыть код своего проекта с работы и поменять все свои рабочие е- 
гдаіГы на свой личный адрес. В любом случае, с помощью г'л.Игег - ЬгапсН вы с таким же 
успехом можете поменять адреса почты в нескольких коммитах за один раз. Вам надо быть 
аккуратным, чтобы не поменять и чужие адреса, поэтому используйте - - сотшіі: - 1 = і11:ег : 
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$ діі т"і1г.ег-ЬгапсІі - -сотті1:-т"іИ:ег ' 

іг [ "$6ІТ_АІІТН0К_ЕМАІІ-" = "зсИасоп§1оса1Ноз1:" ]; 

6ІТ_АІІТН0ЮІАМЕ="5со1:1: СИасоп" ; 
6ІТ_АІІТН0К_ЕМАІІ-="зсНасоп§ехатр1е . сот" ; 
діі сотті1:-1:гее "$§"; 

еізе 

діі сотті1:-Г.гее "$§"; 

Ті' НЕАО 

Эта команда проходит по всем коммитам и переписывает их так, чтобы там был указан 
новый адрес. Так как коммиты содержат значения 5НА-1 своих родителей, эта команда поменяет 
все 8НА в вашей истории, а не только те, в которых есть указанный е-таіі адрес. 

6.5 Отладка с помощью Сіі 

С-іГ также предоставляет несколько инструментов призванных помочь вам в отладке ваших 
проектов. Так как С-іГ сконструирован так, чтобы работать с практически любыми типами 
проектов, эти инструменты довольно общие, но зачастую они могут помочь отловить ошибку 
или её виновника, если что-то пошло не так. 

6.5.1 Аннотация файла 

Если вы отловили ошибку в коде и хотите узнать, когда и по какой причине она была 
внесена, то аннотация файла — лучший инструмент для этого случая. Он покажет вам какие 
коммиты модифицировали каждую строку файла в последний раз. Так что, если вы видите, 
что какой-то метод в коде глючный, то можно сделать аннотацию нужного файла с помощью 
діі Ыате, чтобы посмотреть когда и кем каждая строка метода была в последний раз 
отредактирована. В этом примере используется опция - 1., чтобы ограничить вывод строками 
с 12ой по 22ую: 

$ діі Ыате -I. 12,22 зітріедіі: . гЬ 



М832ге2 


(5С0Г.1: СИасоп 


20Ѳ8 


-03 


-15 


10 


31 


28 


-0700 


12) 


сіег" зМом(г.гее = 'тазііег') 


Л4832ге2 


(ЗсоЫ; СИасоп 


2008 


-03 


-15 


10 


31 


28 


-0700 


13) 


соттапсі( "діг. зНом #{г.гее}") 


Л4832ге2 


(ЗсоЫ: СМасоп 


2008 


-03 


-15 


10 


31 


28 


-0700 


14) 


епсі 


М832ге2 


(ЗсоЫ: СИасоп 


2008 


-03 


-15 


10 


31 


28 


-0700 


15) 




9г"6560е4 


(ЗсоЫ; СИасоп 


2008 


-03 


-17 


21 


52 


20 


-0700 


16) 


(іеТ 1од(г.гее = 'тазіег') 


79еаг'55сІ 


(ЗсоЫ; СИасоп 


2008 


-04 


-06 


10 


15 


08 


-0700 


17) 


соттапсі( "діГ. Іод #{Г.гее}") 


9г"6560е4 


(ЗсоЫ; СИасоп 


2008 


-03 


-17 


21 


52 


20 


-0700 


18) 


епсі 


9г"6560е4 


(ЗсоЫ; СИасоп 


2008 


-03 


-17 


21 


52 


20 


-0700 


19) 




4201=2861 


(Мадпиз СИасоп 


2008 


-04 


-13 


10 


45 


01 


-0700 


20) 


сіег" Ыате(ра1:И) 


42СГ2861 


(Мадпиз СИасоп 


2008 


04- 


13 


10: 


45: 


01 


-0700 


21) 


соттапсі( "діг. Ыате #{ра(:п}") 


42СГ2861 


(Мадпиз СИасоп 


2008 


-04 


-13 


10 


45 


01 


-0700 


22) 


епсі 



Заметьте, что первое поле это частичная 5НА-1 коммита, в котором последний раз менялась 
строка. Следующие два поля это значения полученные из этого коммита — имя автора и дата 
создания коммита. Так что вы легко можете понять кто и когда менял данную строку. Затем 
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идут номера строк и содержимое файла. Также обратите внимание на строки с ~48321 = е2, это 
те строки, которые находятся здесь со времён первого коммита для этого файла. Это коммит, 
в котором этот файл был впервые добавлен в проект, и с тех пор те строки не менялись. Это 
всё несколько сбивает с толку, потому что только что вы увидели по крайней мере три разных 
способа изменить 5НА коммита с помощью но тут вот такое значение. 

Ещё одна крутая вещь в СіГ это то, что он не отслеживает переименования файлов в явном 
виде. Он записывает снимки состояний, а затем пытается выяснить что было переименовано 
неявно уже после того как это случилось. Одна из интересных функций возможная благодаря 
этому заключается в том, что вы можете попросить дополнительно выявить все виды перемещений 
кода. Если вы передадите -Свдіі: Ыате, Сіі проанализирует аннотируемый файл и попытается 
выявить откуда фрагменты кода в нём появились изначально, если они были скопированы 
откуда-то. Недавно я занимался разбиением файла СІТЗегѵегНапсІІег . т на несколько 
файлов, один из которых был СІТРаскІІрІоасІ .т. Вызвав Ыате с опцией -С для СІТ- 
Раскііріоасі . т, я могу понять откуда части кода здесь появились: 

$ діі Ыате -С -I. 141,153 бІТРаскІІрІоасІ . т 



1=3441=5801 


бІТЗегѵегНапсіІег 


ІЛ 


(ЗСОСС 


2009- 


01- 


04 


141) 




Г344Г58СІ 


бІТЗегѵегНапсіІег 


ІЛ 


(ЗСОП 


2009- 


01- 


04 


142) - 


(ѵоісі) даГНегОЬ-есЬЗПазРготС 


Т344Г58СІ 


бІТЗегѵегНапсіІег 


т 


(Зсоіі 


2009- 


01- 


04 


143) { 




70Ьет=сІсІсі 


бІТЗегѵегНапсіІег 


ІЛ 


(зсоіт 


2009- 


03- 


22 


144) 


//М5І_од(@"6АТНЕВ СОММІ 


асЛ1ас80 


бІТРаскІІрІоасІ . ш 




(ЗСОСС 


2009- 


03- 


24 


145) 




асІ11ас80 


бІТРаскІІрІоасІ . ш 




(Зсоіі 


2009- 


03- 


24 


146) 


МЗЗігіпд *рагепі51іа; 


асІ11ас80 


бІТРаскІІрІоасІ . ш 




(ЗСОП 


2009- 


03- 


24 


147) 


ѲІТСоттіт: *сотті(: = [д 


асЛ1ас80 


бІТРаскІІрІоасІ . т 




(5со« 


2009- 


03- 


24 


148) 




асІ11ас80 


бІТРаскІІрІоасІ . ш 




(Зсоіі 


2009- 


03- 


24 


149) 


//М5Юд(@"6АТНЕР СОММІ 


асЛ1ас80 


бІТРаскІІрІоасІ . ш 




(ЗСОП 


2009- 


03- 


24 


150) 




56е1=2саг' 


бІТЗегѵегНапсіІег 


ІЛ 


(ЗсоП 


2009- 


01- 


05 


151) 


ітХсоттіІ:) { 


56е1=2саг' 


бІТЗегѵегНапсіІег 


ІЛ 


(Зсоіі 


2009- 


01- 


05 


152) 


[ге^РісС зеНОЬ 


56е1=2саг' 


бІТЗегѵегНапсіІег 


т 


(ЗСОИИ 


2009- 


01- 


05 


153) 





Это действительно удобно. Стандартно, вам бы выдали в качестве начального коммита 
тот коммит, в котором вы скопировали код, так как это первый коммит, в котором вы поменяли 
эти строки в данном файле. А сейчас С-іГ выдал вам изначальный коммит, в котором эти строки 
были написаны, не смотря на то, что это было в другом файле. 

6.5.2 Бинарный поиск 

Аннотирование файла помогает, когда вы знаете, где у вас ошибка, и есть с чего начинать. 
Если вы не знаете что у вас сломалось, и с тех пор, когда код работал, были сделаны десятки 
или сотни коммитов, вы наверняка обратитесь за помощью к діі. Ьізесі:. Команда Ьі- 
зесі: выполняет бинарный поиск по истории коммитов, и призвана помочь как можно быстрее 
определить в каком коммите была внесена ошибка. 

Положим, вы только что отправили новую версию вашего кода в производство, и теперь вы 
периодически получаете отчёты о какой-то ошибке, которая не проявлялась, пока вы работали 
над кодом, и вы не представляете почему код ведёт себя так. Вы возвращаетесь к своему 
коду, и у вас получается воспроизвести ошибку, но вы не понимаете что не так. Вы можете 
использовать Ьізесі:, чтобы выяснить это. Сначала выполните діі: Ьізесі: 5І:аг {., чтобы 
запустить процесс, а затем діі Ьізесі: ЬасІ, чтобы сказать системе, что текущий коммит, 



172 



5соП СЬасоп Рго Сіі 



Раздел 6.5 Отладка с помощью Сіі 



на котором вы сейчас находитесь, — сломан. Затем, необходимо сказать Ьізесі:, когда было 
последнее известное хорошее состояние с помощью діі Ьізесі: доосі [ хороши й_коммит ] : 

$ діг. Ьізесг. зіагі: 

$ діі ЬізесГ. ЬасІ 

$ діі ЬізесГ. доосі ѵІ.Ѳ 

Візесііпд: 6 геѵізіопз 1ет"1: іо Ііезі &Ті.ег ІЫ5 

[есЬ6е1Ьс347ссесс5г'9350сі878се677г'еЫЗсіЗЬ2] еггог НапсІІіпд оп геро 



Сіт выяснил, что между коммитом, который вы указали как последний хороший коммит 
(ѵі.0), и текущей плохой версией было сделано примерно 12 коммитов, и он выгрузил вам 
версию из середины. В этот момент, вы можете провести свои тесты и посмотреть проявляется 
ли проблема в этом коммите. Если да, то она была внесена где-то раньше этого среднего 
коммита; если нет, то проблема появилась где-то после коммита в середине. Положим, что 
оказывается, что проблема здесь не проявилась, вы говорите Сіг об этом набрав діі Ьізесі: 
доосі и продолжаете свой путь: 

$ діі ЬізесГ. доосі 

Візесііпд: 3 геѵізіопз ІетЧ {о г.езі аІЧег 1:Иіз 
[Ь047Ь02еа83310а70г'сІ603сіс8са'7а6ссІ13сі15с04] зесиге ИИіз ІИіпд 



Теперь вы на другом коммите, посередине между тем, который только что был протестирован 
и вашим плохим коммитом. Вы снова проводите тесты и выясняете, что текущий коммит 
сломан. Так что вы говорите об этом Сіг с помощью діі Ьізесг. ЬасІ: 



$ діг. Ьізесг. ЬасІ 

Візесііпд: 1 геѵізіопз 1ет"1: Со Ііезі аТіег ІЫ5 
[^71се3869Ѳас1 = 49с11 ; Зс9Ьеа38еѲ9а'82а5се6014] сігор ехсерИіопз СаЫе 




Этот коммит хороший, и теперь у СіІ есть вся необходимая информация, чтобы определить 
где проблема была внесена впервые. Он выдаёт вам 5НА-1 первого плохого коммита и некоторую 
информацию о нём, а также какие файлы были изменены в этом коммите, так что вы сможете 
понять что случилось, что могло внести эту ошибку: 

$ діі Ьізесг. доосі 

Ь047Ь02еа83310а70г'сІ603сіс8са'7а6са'13сІ15с04 із гігзГ. ЬасІ соттіі 
соттіі Ь047Ь02еа83310а701 = а , 603а , с8сс17а6са , 13а , 15с04 
АиСМог: НуеІГ. <р^уеГ.Г.§ехатр1е . сот> 
Оаіе: Тие Зап 27 14:48:32 2009 -0800 

зесиге г.Ніз іИіпд 

: 040000 040000 40ееЗе7821Ь895е52с1695092а'Ь9ЬсІс4с61а , 1730 
1 = 24а , Зс6еЬст'с639Ыа3814550е62а , 60Ь8е68а8е4 М сопгід 
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Если вы закончили, необходимо выполнить діі Ьізесі: г езеі:, чтобы сбросить НЕАБ 
туда где он был до начала бинарного поиска, иначе вы окажетесь в странном состоянии: 

$ діі Ьізесі: гезеі: 



Это мощный инструмент, который поможет вам за считанные минуты проверить сотни 
коммитов в поисках появившейся ошибки. На самом деле, если у вас есть сценарий (всгірі), 
который возвращает на выходе 0, если проект хороший и не 0, если проект плохой, то вы 
можете полностью автоматизировать діі Ьізесі:. Для начала ему снова надо задать область 
бинарного поиска задав известные хороший и плохой коммиты. Если хотите, можете сделать 
это указав их команде Ьізесі: ЗІагЪ, указав известный плохой коммит первым, а хороший 
вторым: 

$ діі Ьізесі: зіагі НЕАЭ ѵі.0 
$ діі Ьізесі: гип Іезі-еггог . зИ 



Сделав так, вы получите, что іезі-еггог.згі будет автоматически запускаться на каждом 
выгруженном коммите, пока С-іГ не найдёт первый сломанный коммит. Вы также можете запускать 
что-нибудь типа таке или таке ЬезЪз или что-то там ещё, что запускает ваши автоматические 
тесты. 

6.6 Подмодули 

Зачастую случается так, что во время работы над некоторым проектом, появляется необходимость 
использовать внутри него ещё какой-то проект. Возможно, библиотеку разрабатываемую сторонними 
разработчиками или разрабатываемую вами обособленно и используемую в нескольких родительских 
проектах. Типичная проблема возникающая при использовании подобного сценария это, как 
сделать так, чтобы иметь возможность рассматривать эти два проекта как отдельные, всё же 
имея возможность использовать один проект внутри другого. 

Вот пример. Предположим, вы разрабатываете веб-сайт и создаёте Аіот-ленты. И вместо 
того, чтобы писать собственный код генерирующий Агот, вы решили использовать библиотеку. 
Вы, вероятно, должны либо подключить нужный код с помощью разделяемой библиотеки, 
такой как устанавливаемый модуль СРАЫ или пакет КлЪуСет, либо скопировать исходный код 
в дерево собственного проекта. Проблема с подключением библиотеки в том, что библиотеку 
сложно хоть как-то модифицировать под свои нужды, и зачастую её сложнее распространять. 
Ведь вы вынуждены удостовериться в том, что эта библиотека доступна на каждом клиенте. 
Проблема с включением кода в ваш собственный проект в том, что любые изменения, вносимые 
вами, могут конфликтовать с изменениями, которые появятся в основном проекте, и эти изменения 
будет сложно слить. 

С-іГ решает эту задачу используя подмодули (виЪтоаше). Подмодули позволяют содержать 
репозиторий С-іІ как подкаталог другого репозитория Сіі. Это даёт возможность клонировать 
ещё один репозиторий внутрь проекта и держать коммиты для этого репозитория отдельно. 
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6.6.1 Начало использования подмодулей 

Предположим, вы хотите добавить библиотеку Каск (интерфейс шлюза веб-сервера КлЪу) 
в свой проект, возможно внося свои собственные изменения в него, но продолжая сливать их с 
изменениями основного проекта. Первое что вам требуется сделать, это клонировать внешний 
репозиторий в подкаталог. Добавление внешних проектов в качестве подмодулей делается 
командой діі: зиЬтосІиІе асісі: 

$ діі зиЬтосіііІе асісі діі; : //дііНиЬ . сот/сНпеикігсІіеп/гаск . діі гаек 

Іпіііаіігесі етрііу Сіі герозі1:огу іп /орІі/зиЫезі/гаск/ . діі/ 

гетоіе: СоипПпд оЬзес1:з: 3181, сіопе. 

гетоЬе: Сотргеззіпд оЬзес1:з: 1ѲѲ% (1534/1534), сіопе. 

гетоНе: ТоИаІ 3181 (сІеІИа 1951), геизеа 1 2623 (сіеііа 1603) 

Кесеіѵіпд оЬіесГз: 100% (3181/3181), 675.42 КіВ | 422 КіВ/з, сіопе. 

Кезоіѵіпд сІеІИаз: 100% (1951/1951), сіопе. 

Теперь у вас внутри проекта в подкаталоге с именем гаек находится проект Каск. Вы 
можете переходить в этот подкаталог, вносить изменения, добавить ваш собственный доступный 
для записи внешний репозиторий для отправки в него своих изменений, извлекать и сливать 
из исходного репозитория, и многое другое. Если вы выполните діі зг.аг.115 сразу после 
добавления подмодуля, то увидите две вещи: 



$ діі зіаііиз 






# Оп ЬгапсИ тазііег 






# СИапдез 1:о Ье соттііііесі : 






# (изе "діі гезеі НЕАй <-Гі1е>.. 


. " 1:о ипзСаде) 




# 






# пем 'Гііе: . дііітосіиіез 






# пем 1 = і1е: гаек 






# 







Вначале вы заметите файл . дііітосіиіез. Это конфигурационный файл, который содержит 
соответствие между ЦКЬ проекта и локальным подкаталогом, в который бьш загружен подмодуль: 

$ саі . ді^тосіиіез 
[зиЬтосІиІе "гаек"] 
раіИ = гаек 

игі = ді1:://дііІіиЬ.сот/сНпеикігсІіеп/гаск.ді1: 



Если у вас несколько подмодулей, то в этом файле будет несколько записей. Важно обратить 
внимание на то, что этот файл находится под версионным контролем вместе с другими вашими 
файлами, так же как и файл .діііідпоге. Он отправляется при выполнении р и 5 И и загружается 
при выполнении риіі вместе с остальными файлами проекта. Так другие люди, которые 
клонируют этот проект, узнают откуда взять проекты-подмодули. 

В следующем листинге вывода діі: 5І:а1:и5 присутствует элемент гаек. Если вы выполните 
діі: сИ'Г'Г для него, то увидите кое-что интересное: 
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$ діі гіітТ --сасИей гаек 
сіігТ - - діт: а/гаск Ь/гаск 
пей -Гііе шосіе 16ѲѲ00 
ІПСІех ѲѲѲѲѲѲО. .Ѳ8СІ709Г 
— /сіеѵ/пиіі 
+++ Ь/гаск 
і§ -0,0 +1 т 

+5иЬргсоес1: соттіі: 08сІ709т'78Ь8с5Ь0г'ЬеЬ7821е37г'а53е69аг'сг'433 



Хотя гаек является подкаталогом в вашем рабочем каталоге, СіГ видит его как подмодуль 
и не отслеживает его содержимое, если вы не находитесь в нём. Вместо этого, Сіі записывает 
его как один конкретный коммит из этого репозитория. Если вы производите изменения в 
этом подкаталоге и делаете коммит, основной проект замечает, что НЕАБ в подмодуле был 
изменён, и регистрирует тот хеш коммита, над которым вы в данный момент завершили работу 
в подмодуле. Таким образом, если кто-то склонирует этот проект, он сможет воссоздать окружение 
в точности. 

Это важная особенность подмодулей - вы запоминаете их как определенный коммит (состояние), 
в котором они находятся. Вы не можете записать подмодуль под ссылкой тазііег или какой- 
либо другой символьной ссылкой. 

Если вы создадите коммит, то увидите что-то вроде этого: 

$ діі соттіі: -т '■рігзі: соттіі зиЬтосіііІе гаек' 

[тазіег 0550271] ■рігзі: соттИ иісіі зиЬтосіиІе гаек 

2 ■рііез сИапдесі, 4 іпзег1:іопз( + ) , 0 сіе1е1:іопз( - ) 

сгеаііе тосіе 100644 . дігтосііііез 



сгеаіе тосіе 160000 гаек 




Обратите внимание на режим 160000 для элемента гаек. Это специальный режим в Сіі, 
который по существу означает, что в качестве записи в каталоге сохраняется коммит, а не 
подкаталог или файл. 

Вы можете расценивать каталог гаек как отдельный проект и обновлять ваш основной 
проект время от времени с указателем на самый последний коммит в данном подпроекте. Все 
команды СіГ работают независимо в двух каталогах: 

$ діі Іод -1 

соттіі 0550271328а0038865аасі6331е620ссі7238601ЬЬ 
Аи1:Ьог: ЗсоЫ: СИасоп <зсИасоп§дтаі1.сот> 
Оаіе: ТИи Арг 9 09:03:56 2009 -0700 

■рігзі: соттИ ыіі.Ь зиЬтосіиІе гаек 
$ ссі гаек/ 
$ діі Іод -1 

соттіі 08с1709т'78Ь8с5Ь0т'ЬеЬ7821е37г'а53е69аг'сг'433 
Аи1:Ьог: СИгіз1:іап МеикігсИеп <сЬпеикігсІіеп§дтаі1.сот> 
Оаіе: МесІ Маг 25 14:49:04 2009 +0100 

Ооситепі: ѵегзіоп сИапде 
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6.6.2 Клонирование проекта с подмодулями 



Сейчас мы склонируем проект содержащий подмодуль. После получения такого проекта, 
в вашей копии будут каталоги содержащие подмодули, но пока что без единого файла в них: 



$ діі сіопе ді1:://дііПиЬ.сот/зсНасоп/турго]ес1:.діІ: 




Іпіііаіігесі етріу Оіі герозі1:огу іп /ор1:/тургозес1:/.ді1:/ 




гетоЬе: Соипііпд оЬзесІіз: 6, сіопе. 




гето^е: Сотргеззіпд оЬзесІіз: 100% (4/4), сіопе. 




гетоііе: То1:а1 6 (сіеііа 0), геизесі 0 (сіе11:а Ѳ) 




Кесеіѵіпд оЬзесІіз: 100% (6/6), сіопе. 




$ ссі тургозесі: 




$ 1з -1 




ИоИаІ 8 




-ГИ-Г-Г-- 1 зсМасоп асітіп 3 Арг 9 09:11 КЕАЭМЕ 




йгихг-хг-х 2 зсИасоп асітіп 68 Арг 9 09:11 гаек 




$ 1з гаек/ 




$ 









Каталог гаек присутствует, но он пустой. Необходимо выполнить две команды: діі. 
зиЬтосІиІе іпіі. для инициализации вашего локального файла конфигурации, и діі: зиЬ - 
тосіиіе ирсіаііе для получения всех данных из подмодуля и перехода к соответствующему 
коммиту, указанному в вашем основном проекте: 

$ діі зиЬтосіиІе іпіі 

ЗиЬтосІиІе 'гаек' (ді1:://дііІіиЬ.сот/сНпеикігсНеп/гаск.ді1:) гедізіегесі 'Тог раіЬ 'гаек' 
$ дхі зиЬтосіііІе ирсіаіе 

Іпіііаіігесі етріу Сіі герозіііогу іп /ор1:/тургозес1:/гаск/.ді1:/ 

гетоЬе: СоипПпд оЬзес1:з: 3181, Йопе. 

гетоііе: Сотргеззіпд оЬзес1:з: 100% (1534/1534), сіопе. 

гетоіе: ТоИаІ 3181 (аеІИа 1951), геизеа 1 2623 (аеІГа 1603) 

Весеіѵіпд оЬзесИз: 100% (3181/3181), 675.42 КіВ | 173 КіВ/з, сіопе. 

Кезоіѵіпд сіеІИаз: 100% (1951/1951), аопе. 

ЗиЬтоаиІе раНИ 'гаек': сИескесІ оиі ' 08а'709г78Ь8с5Ь0т'ЬеЬ7821е37т'а53е69аг'сг'433 ' 



Теперь ваш подкаталог гаек точно в том состоянии, в котором он был, когда вы раньше 
делали коммит. Если другой разработчик внесёт изменения в код гаек и затем сделает коммит, 
а вы потом обновите эту ссылку и сольёте её, то вы получите что-то странное: 

$ діі тегде огідіп/тазііег 
ирсіаііпд 0550271. .85аЗеее 
Разі: -ропл/агс) 
гаек | 2 +- 

1 -рііез сНапдесІ, 1 іпзег1:іопз( + ) , 1 с!е1е1:іопз( - ) 
[таз1:ег*]$ дИ зіаіиз 

# Оп ЬгапсН тазЬег 

# СМапдеа 1 Ьи1: поі: ирсіаііесі : 

# (изе "діі асісі <-рі1е>..." Ьо ирсіа1:е ыЬаі. иііі Ье соттШесІ) 

# (изе "діі сИескоиі -- <1 = і1е>..." Ьо сіізсагсі сИапдез іп ыогкіпд сіігесіогу) 
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# 

# тосіітіеа': гаек 

# 



Вы слили то, что по существу является изменением указателя на подмодуль. Но при этом 
обновления кода в каталоге подмодуля не произошло, так что всё выглядит так, как будто вы 
имеете грязное состояние в своём рабочем каталоге: 

$ діі йіТТ 

сіігТ - - діт: а/гаск Ь/гаск 
іпсіех 6с5е70Ь. .08СІ709-Г 16000Ѳ 
— а/гаск 
+++ Ь/гаск 
і§ -1 +1 @@ 

-ЗиЬргозесИ соттіі: 6с5е70Ь984а60ЬЗсеса , 395есІа , 5Ь48а7575Ьт"58е0 
+5иЬргозесИ соттіі: 08сІ709т"78Ь8с5Ь0г'ЬеЬ7821е37г'а53е69ат'сг'433 



Это всё из-за того, что ваш указатель на подмодуль не соответствует тому, что на самом 
деле находится в каталоге подмодуля. Чтобы исправить это, необходимо снова выполнить діі 
зиЬшосІиІе ирсіаііе: 

$ діі зиЬтосіііІе ирсіаіе 

гетоСе: СоипСіпд оЬзесІіз: 5, сіопе. 

гетоСе: Сотргеззіпд оЬзесГз: 100% (3/3), сіопе. 

гетоСе: То1:а1 3 (сіеііа 1), геизесі 2 ( сІе1т:а 0) 

ІІпраскіпд оЬзесіз: 100% (3/3), сіопе. 

Ргот діі@ді1:ИиЬ . сот : зсИасоп/гаск 

08СІ709-Г . . 6с5е70Ь таз1:ег -> огідіп/тазіег 
ЗиЬтосІиІе раіЬ 'гаек': сИескесі оиі ' 6с5е70Ь984а60ЬЗсессі395есІсІ5Ь48а7575Ы = 58е0 ' 



Вы вынуждены делать так каждый раз, когда вы получаете изменения подмодуля в главном 
проекте. Это странно, но это работает. 

Распространённая проблема возникает, когда разработчик делает изменения в своей локальной 
копии подмодуля, но не отправляет их на общий сервер. Затем он создаёт коммит содержащий 
указатель на это непубличное состояние и отправляет его в основной проект. Когда другие 
разработчики пытаются выполнить д зиЬтосІиІе ирсіаііе, система работы с подмодулями 
не может найти указанный коммит, потому что он существует только в системе первого разработчика. 
Если такое случится, вы увидите ошибку вроде этой: 



$ діі зиЬтосіиІе ирсіаіе 

гаіаі: гетегепсе ізп'і а Игее: 6с5е70Ь984а60ЬЗсеса'395еа , сІ5Ь48а7575Ьт"58е0 

ипаЫе Со сИескоиН 1 6с5е70Ь984а60ЬЗсеса , 395еа , а , 5Ьа7575Ы = 58е0 1 іп зиЬтосіиІе раіЬ 'гаек' 




Вам надо посмотреть, кто последним менял подмодуль: 



178 



5соП СЬасоп Рго Сіі 



Раздел 6.6 Подмодули 



$ діі Іод -1 гаек 

соттіі 85аЗеее996800гст'а91е2119372сІс14172Ьг'76678 
АиІіИог: ЗсоЫ: СМасоп <зсИасоп§дтаі1.сот> 
Оаіе: ТИи Арг 9 09:19:14 2009 -0700 

асісіесі а зиЬтосІиІе ге-Гегепсе I иііі пеѵег таке риЫіс. ИаЬаМаМаИа! 

А затем отправить этому человеку письмо со своими возмущениями. 

6.6.3 Суперпроекты 

Иногда, разработчики хотят объединить подкаталоги крупного проекта в нечто связанное, 
в зависимости от того, в какой они команде. Это типично для людей перешедших с СѴ5 или 
ЗиЬѵегвіоп, где они определяли модуль или набор подкаталогов, и они хотят сохранить данный 
тип рабочего процесса. 

Хороший способ сделать такое в СіГ — это сделать каждый из подкаталогов отдельным 
Сіг-репозиторием, и создать Сіг-репозиторий для суперпроекта, который будет содержать несколько 
подмодулей. Преимущество такого подхода в том, что вы можете более гибко определять 
отношения между проектами при помощи меток и ветвей в суперпроектах. 

6.6.4 Проблемы с подмодулями 

Однако, использование подмодулей не обходится без загвоздок. Во-первых, вы должны 
быть относительно осторожны работая в каталоге подмодуля. Когда вы выполняете команду 
діі зиЬтосІиІе ирсіаііе, она возвращает определённую версию проекта, но не внутри 
ветви. Это называется состоянием с отделённым НЕАБ (аеіасЬесі НЕАБ) — это означает, что 
файл НЕАБ указывает на конкретный коммит, а не на символическую ссылку. Проблема в том, 
что вы, скорее всего, не хотите работать в окружении с отделённым НЕАБ, потому что так 
легко потерять изменения. Если вы сделаете первоначальный зиЬтосіиІе ирсіаіе, сделаете 
коммит в каталоге подмодуля не создавая ветки для работы в ней, и затем вновь выполните д і 1: 
зиЬтосІиІе ирсіаііе из основного проекта, без создания коммита в суперпроекте, Сіг затрёт 
ваши изменения без предупреждения. Технически вы не потеряете проделанную работу, но у 
вас не будет ветки указывающей на неё, так что будет несколько сложновато её восстановить. 

Для предотвращения этой проблемы, создавайте ветвь, когда работаете в каталоге подмодуля 
с использованием команды діі: сИескоиІ: - Ь мог к или какой-нибудь аналогичной. Когда 
вы сделаете обновление подмодуля командой зиЬтосІиІе ирсіаііе в следующий раз, она все 
же откатит вашу работу, но, по крайней мере, у вас будет указатель для возврата назад. 

Переключение веток с подмодулями в них также может быть мудрёным. Если вы создадите 
новую ветку, добавите туда подмодуль и затем переключитесь обратно, туда где не было этого 
подмодуля, вы все ещё будете иметь каталог подмодуля в виде неотслеживаемого каталога: 

$ діі сИескоиІ: -Ь гаек 
ЗмИсИес! Ьо а пей ЬгапсИ "гаек" 

$ діі зиЬтосІиІе асісі ді1:@ді1:ИиЬ.сот:5сИасоп/гаск.ді1: гаек 
Іпііііаіігесі етріу 6і(: герозИогу іп /ор1:/турго^гаск/.ді1:/ 
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Кесеіѵіпд оЬзесИз: 100% (3184/3184), 677.42 КіВ 


| 34 КіВ/з, сіопе. 


Кезоіѵіпд гіеІИаз: 100% (1952/1952), сіопе. 




$ діг. соттіі: -ат 1 асісіесі гаек зиЬтосІиІе ' 




[гаек сс49а69] асісіесі гаек зиЬтосІиІе 




2 -Гііез сНапдесІ, 4 іп5егГ.іопз( + ) , 0 сІе1е!:іоп5( ■ 


) 


сгеаіе тосіе 100644 . дішосііііез 




сгеаііе тосіе 160000 гаек 




ф у-і-і- ыісокс)иі_ шаысг 




ЗмИсИес! 1:о ЬгапсИ "таз1:ег" 




$ діі зіаііиз 




# Оп ЬгапсИ тазііег 




# Ііпіігаскесі т"і1ез: 




# (изе " діт: асісі <ті1е>..." Со іпсіисіе іп иМаі 


мііі Ье соттіг.г.ео') 


# 

# гаек/ 





Вы будете вынуждены либо переместить каталог подмодуля в другое место, либо удалить 
его. В случае удаления вам потребуется клонировать его снова при переключении обратно, 
и тогда вы можете потерять локальные изменения или ветки, которые не были отправлены в 
основной репозиторий. 

Последняя проблема, которая возникает у многих, и о которой стоит предостеречь, возникает 
при переходе от подкаталогов к подмодулям. Если вы держали некоторые файлы под версионным 
контролем в своём проекте, а сейчас хотите перенести их в подмодуль, вам надо быть осторожным, 
иначе СіІ разозлится на вас. Допустим, вы держите файлы гаек в подкаталоге проекта, и вы 
хотите вынести его в подмодуль. Если вы просто удалите подкаталог и затем выполните 5ііЬ - 
шосіиіе асісі, Сіі наорёт на вас: 



$ гт -Р-Г гаек/ 

$ діі зиЬтосІііІе асісі ді1:@ді1:ИиЬ.сот:зсИасоп/гаск.ді1: гаек 
'гаек' аігеасіу ехізіз іп іЬе іпсіех 




Вначале вам следует убрать каталог Г ас к из индекса (убрать из под версионного контроля). 
Потом можете добавить подмодуль: 

$ діі гт -г гаек 

$ діі зиЬтосІиІе асісі ді1:@ді1:ИиЬ.сот:зсИасоп/гаск.ді1: гаек 

Іпі1:іа1ігеа' етрЬу Сіі герозііогу іп /орС/СезСзиЬ/гаск/ . длЛ/ 

гетоііе: СоипПпд ок^ес^в: 3184, сіопе. 

гетоСе: Сотргеззіпд оЬзесСз: 100% (1465/1465), сіопе. 

гетоНе: ТоИаІ 3184 (сІеИа 1952), геизеа 1 2770 (сІеІИа 1675) 

Ресеіѵіпд оЬзесІз: 100% (3184/3184), 677.42 КіВ | 88 КіВ/з, сіопе. 

Кезоіѵіпд сіеІИаз: 100% (1952/1952), сіопе. 

Теперь, предположим, вы сделали это в ветке. Если вы попытаетесь переключиться обратно 
на ту ветку, где эти файлы всё еще в актуальном дереве, а не в подмодуле, то вы получите такую 
ошибку: 
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$ діі сііескоиі: тазіег 

еггог: ІІп1:гаскесІ иогкіпд Ігее Рііе ' гаск/АІІТНОКЗ' иоиісі Ье оѵепл/гШеп Ьу тегде. 



Вам следует переместить каталог подмодуля гаек, перед тем, как вы сможете переключиться 
на ветку, которая не содержит его: 

$ тѵ гаек /ітр/ 
$ діі сііескоиі: тазіег 
5иі1:сІіесІ 1:о ЬгапсИ "тазГег" 
$ 1з 

КЕАРМЕ гаек 



Затем, когда вы переключитесь обратно, вы получите пустой каталог гаек. Вы сможете 
либо выполнить діг. зиЬтосІиІе и рсіаг_е для повторного клонирования, или вернуть содержимое 
вашего каталога /г_шр/гаск обратно в пустой каталог. 

6.7 Слияние поддеревьев 

Теперь, когда вы увидели сложности системы подмодулей, давайте посмотрим на альтернативный 
путь решения той же проблемы. Когда СК выполняет слияние, он смотрит на то, что требуется 
слить воедино и потом выбирает подходящую стратегию слияния. Если вы сливаете две ветви, 
Сіг использует рекурсивную (гесигзіѵе) стратегию. Если вы объединяете более двух ветвей, 
СіГ выбирает стратегию осьминога (осіорив). Эти стратегии выбираются за вас автоматически 
потому, что рекурсивная стратегия может обрабатывать сложные трёхсторонние ситуации слияния 
— например, более чем один общий предок — но она может сливать только две ветви. Слияние 
методом осьминога может справиться с множеством веток, но является более осторожным, 
чтобы предотвратить сложные конфликты, так что этот метод является стратегией по умолчанию 
при слиянии более двух веток. 

Однако, существуют другие стратегии, которые вы также можете выбрать. Одна из них — 
слияние поддеревьев (киЬігее), и вы можете использовать его для решения задачи с подпроектами. 
Сейчас вы увидите как выполнить то же встраивание гаек как и в предыдущем разделе, но с 
использованием стратегии слияния поддеревьев. 

Идея слияния поддеревьев в том, что вы имеете два проекта, и один из проектов отображается 
в подкаталог другого и наоборот. Если вы зададите в качестве стратегии слияния метод виЬ- 
Ігее, то Сіт будет достаточно умным, чтобы понять, что один из проектов является поддеревом 
другого и выполнит слияние в соответствии с этим. И это довольно удивительно. 

Сначала добавьте приложение Каск в свой проект. Добавьте проект Каск как внешнюю 
ссылку в свой собственный проект, и затем поместите его в собственную ветку: 

$ діі гето1:е асісі гаск_гето1:е ді1:§ді1:ИиЬ . сот : зсИасоп/гаск . діі: 

$ дхі ■ре^сН гаск_гетоіе 

магпіпд: по соттоп сотті1:з 

гетоЬе: Соипііпд ок^ес^з: 3184, сіопе. 
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гетоііе: Сотргеззіп 


д оЬзесИз: 100% (1465/1465), сіопе. 


гетог.е: Тоіаі 3184 


(сіе1т:а 1952), геизеа 1 277Ѳ (сІеІИа 1675) 


Кесеіѵіпд о^есСз: 


100% (3184/3184), 677.42 КІВ | 4 КІВ/з, СІОПе. 


Кезоіѵіпд сіеИаз: 


100% (1952/1952), Сіопе. 


Ргот діі@ді1:НиЬ.сот:зсНасоп/гаск 


* [пем ЬгапсИ] 


Ьиіісі -> гаск_гетог.е/Ьиі1о' 


* [пей Ьгапсп] 


таз1:ег -> гаск_гето1:е/таз1:ег 


* [пем ЬгапсИ] 


гаск-Ѳ.4 -> гаск_гето1е/гаск-0 . 4 


* [пем ЬгапсИ] 


гаск-Ѳ.9 -> гаск_гето1е/гаск-0 . 9 


$ діі сПескоиІ: -Ь 


гаск_Ьгапсп гаск_гето1:е/таз(:ег 


ВгапсИ гаск_ЬгапсИ 


зеі ир Ьо ігаск гетоіе ЬгапсИ ге-Гз/гето(:е5/гаск_гето1:е/таз1:ег . 


5иі1:сІіесІ 1:о а пей 


ЬгапсИ "гаск_ЬгапсІі" 



Теперь у вас есть корень проекта Каск в ветке гаск_Ьгапсгі и ваш проект в ветке таз - 
гег. Если вы переключитесь на одну ветку, а затем на другую, то увидете, что содержимое их 
корневых каталогов различно: 



$ 1з 








АиТНОРЗ КМ0Ш-І55ЫЕ5 


Вакег'Ие 


СОПІГІЬ 


ІіЬ 


С0РУІМ6 КЕАРМЕ 


Ьіп 


ехатріе 


Ьезі: 


$ дИ сИескоиІ: тазіег 








ЗиіісПесІ іо ЬгапсИ "тазГег" 








$ 1з 








РЕАРМЕ 









Допустим, вы хотите поместить проект Каск в подкаталог своего проекта в ветке таз - 
1:ег. Вы можете сделать это в СіГе командой діі геасі-1:гее. Вы узнаете больше про 
команду геасІ-1:гееиеё друзей в Главе 9, а пока достаточно знать, что она считывает корень 
дерева одной ветки в индекс и рабочий каталог. Вам достаточно переключиться обратно на 
ветку тазііег, и вытянуть ветвь гаек в подкаталог гаек вашего основного проекта из ветки 
тазііег: 

$ діі геасі-1:гее - -ргегіх=гаск/ -и гаск_ЬгапсИ 



После того как вы сделаете коммит, все файлы проекта Каск будут находиться в этом 
подкаталоге — будто вы скопировали их туда из архива. Интересно то, что вы можете довольно 
легко слить изменения из одной ветки в другую. Так, что если проект Каск изменится, вы 
сможете вытянуть изменения из основного проекта, переключившись в его ветку и выполнив 
діі: риіі: 

$ діі сИескоиІ: гаск_ЬгапсИ 
$ діі риіі 



Затем, вы можете слить эти изменения обратно в вашу главную ветку. Можно использовать 
діі: тегде - з зиЫ:гее — это сработает правильно, но тогда Сіі кроме того объединит 
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вместе истории, чего вы, вероятно, не хотите. Чтобы получить изменения и заполнить сообщение 
коммита, используйте опции --здиазНи-- по-сотшіі: вместе с опцией стратегии -5 зиЬ- 
1:гее: 

$ діі сгіескоиг. тазг.ег 

$ діі тегде --здиазП -з зиЫігее - -по-соттіі гаск_Ьгапсгі 
ЗдиазП соттіг. -- пог. ирсіа1:іпд НЕАЭ 

Аиііотаііс тегде мепг. меіі; зЬоррес! Ье-Гоге соттіг.г.іпд аз гедиезг.есі 



Все изменения из проекта Каск слиты и готовы для локальной фиксации. Вы также можете 
сделать наоборот — внести изменения в подкаталог гаек вашей ветки тазііег, и затем слить 
их в ветку гаск_Ьгапсгі, чтобы позже представить их мейнтейнерам или отправить их в 
основной репозиторий проекта с помощью діі риз И. 

Для получения разности между тем, что у вас есть в подкаталоге гаек и кодом в вашей 
ветке гаск_ЬгапсИ, чтобы увидеть нужно ли вам объединять их, вы не можете использовать 
нормальную команду Вместо этого вы должны выполнить діі сИ'Г'Г - 1:гее с веткой, 

с которой вы хотите сравнить: 

$ діі сИ'гТ-г.гее -р гаск_Ьгапсгі 



Или, для сравнения того, что в вашем подкаталоге гаек с тем, что было в ветке тазііег 
на сервере во время последнего обновления, можно выполнить: 

$ діі с1ітТ-1:гее -р гаск_гето1:е/таз(:ег 



6.8 Итоги 

Вы познакомились с рядом продвинутых инструментов, которые позволяют вам манипулировать 
вашими коммитами и индексом более совершенно. Когда вы замечаете проблему, то сможете 
легко выяснить, каким коммитом она внесена, когда и кем. Если вы хотите использовать 
подпроекты в вашем проекте — вы узнали несколько путей, как приспособится к этим нуждам. 
С этого момента, вы должны быть в состоянии делать большинство вещей в Сіі, которые 
вам будут необходимы повседневно в командной строке, и будете чувствовать себя при этом 
комфортно. 
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До этого момента мы описывали основы того, как СіІ работает, и как его использовать. 
Также мы познакомились с несколькими предоставляемыми Сіі'ом инструментами, которые 
делают его использование простым и эффективным. В этой главе мы пройдёмся по некоторым 
действиям, которые вы можете предпринять, чтобы заставить С-іГ работать в нужной именно 
вам манере. Мы рассмотрим несколько важных настроек и систему перехватчиков (Ьоок). С 
их помощью легко сделать так, чтобы С-іГ работал именно так как вам, вашей компании или 
вашей группе нужно. 

7.1 Конфигурирование Ск 



В первой главе вкратце было рассказано, как можно изменить настройки СіІ с помощью 
команды діі соітРід. Одна из первых вещей, которую мы тогда сделали, это установили 
свои имя и е-таіі адрес: 



$ діь 


соггГід 


--дІоЬаІ изег 


, пате ";іопп Оое" 


$ діь 


соггГід 


--дІоЬаІ изег 


, етаіі ^Нпсіоеіехатріе.сот 



Теперь мы разберём пару более интересных опций, которые вы можете задать тем же 
образом, чтобы настроить С-іГ под себя. 

Мы уже рассмотрели некоторые детали настройки С-іГ в первой главе, но давайте сейчас 
быстренько пройдёмся по ним снова. С-іГ использует набор конфигурационных файлов для 
задания желаемого нестандартного поведения. Первым местом, в котором С-іГ ищет заданные 
параметры, является файл /еіс/діісоітРід, содержащий значения, действующие для всех 
пользователей системы и всех их репозиториев. Когда вы передаёте діі: согтРід опцию 
- - 5уз1:ет, происходит чтение или запись именно этого файла. 

Следующее место, в которое Сіі заглядывает, это файл ~/ . дИсогтРід, который для 
каждого пользователя свой. Вы можете заставить С-іГ читать или писать этот файл, передав 
опцию - -дІоЬаІ. 

И наконец, С-іг ищет заданные настройки в конфигурационном файле в Сіг-каталоге ( . д і 1: / 
согтРід) того репозитория, который вы используете в данный момент. Значения оттуда относятся 
к данному конкретному репозиторию. Значения настроек на новом уровне переписывают 
значения, заданные на предыдущем уровне. Поэтому, например, значения из . діі/ соітГід 
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перебивают значения в /ег. с/дІг_СОПт"Ід. Позволяется задавать настройки путём редактирования 
конфигурационного файла вручную, используя правильный синтаксис, но, как правило, проще 
во спользоваться командой д і 1: согтРід. 

7.1.1 Основные настройки клиента 

Настройки конфигурации, поддерживаемые СіІ'ом, можно разделить на две категории: 
клиентские и серверные. Большинство опций — клиентские, они задают предпочтения в вашей 
личной работе. Несмотря на то, что опций доступно великое множество, мы рассмотрим 
только некоторые из них — те, которые широко используются или значительно влияют на 
вашу работу. Многие опции полезны только в редких случаях, которые мы не будем здесь 
рассматривать. Если вы хотите посмотреть список всех опций, которые есть в вашем СіСе, 
выполните: 

$ діі согтГід --пеір 



В странице руководства для діі соітРід все доступные опции описаны довольно подробно. 

соге.есіког Для создания и редактирования сообщений коммитов и меток СіІ по умолчанию 
использует тот редактор, который установлен текстовым редактором по умолчанию в вашей 
системе, или, как запасной вариант, редактор Ѵі. Чтобы сменить это умолчание на что-нибудь 
другое, используйте настройку соге.есІІ1:ог: 

$ діі согтГід --дІоЬаІ соге . есіііог етасз 



Теперь неважно, что установлено в качестве вашего редактора по умолчанию в переменной 
оболочки, при редактировании сообщений СіГ будет запускать Етасв. 

соттк.іетріаіе Если установить в этой настройке путь к какому-нибудь файлу в вашей 
системе, СіІ будет использовать содержимое этого файла в качестве сообщения по умолчанию 
прикоммите. Например, предположим, что вы создали шаблонный файл $НОМЕ/ . дііітеззаде . І.ХІ., 
который выглядит следующим образом: 

заголовок 
что произошло 
[карточка: X] 

Чтобы попросить СіГ использовать это в качестве сообщения по умолчанию, которое будет 
появляться в вашем редакторе при выполнении діі соттіі:, задайте значение настройки 
сотшіі: . 1:етр1аг.е: 
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$ дИ согтГід --дІоЬаІ соттіь.ііетріаіе $НОМЕ/ . діітеззаде . Схі: 
$ діг. соттіг. 

После этого, когда во время создания коммита запустится ваш редактор, в нём в качестве 
сообщения-заглушки будет находиться что-то вроде такого: 

заголовок 
что произошло 
[карточка: X] 

# Ріеазе епг.ег Ьпе соттіг. теззаде ■Тог уоиг сИапдез. Ипез зг.агг.іпд 

# иіігі '#' иііі Ье ідпогесі, апсі ап етрг.у теззаде аЬогг.5 ІИе соттіг.. 

# Оп ЬгапсИ тазЬег 

# СНапдез іо Ье соттіггеіі: 

# (изе "діі: гезеі НЕАО <-Гі1е>..." г.о ипзііаде) 

# 

# тосИ'Пеа': ІіЬ/Ьезі . гЬ 

# 

" .дІ1:/СОММІТ_Е0ІТМ5С" 141, 297С 

Если у вас существует определённая политика для сообщений коммитов, то задание шаблона 
соответствующего этой политике и настройка СіІ на использование его по умолчанию могут 
увеличить вероятность того, что этой политики будут придерживаться постоянно. 

соге.ра§ег Настройка соге.ра§ег определяет, какой пейджер использовать при постраничном 
отображении вывода таких команд, как Іод и сИ'РТ. Вы можете указать здесь тоге или 
свой любимый пейджер (по умолчанию используется 1е 5 5), или можно отключить его, указав 
пустую строку: 

$ діг. соп-рід --дІоЬаІ соге.радег 11 

Если это выполнить, СіГ будет выдавать весь вывод полностью для всех команд вне зависимости 
от того насколько он большой. 

и§ег.8І§піп§кеу Если вы делаете подписанные аннотированные метки (смотри Главу 2), то, 
чтобы облегчить этот процесс, можно задать свой СРС-ключ для подписи в настройках. Задать 
ГО своего ключа можно так: 

$ діг. согтГід --дІоЬаІ изег . зідпіпдкеу <ісІ-дрд-ключа> 
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Теперь, чтобы подписать метку, не обязательно каждый раз указывать свой ключ команде 
діг. Гад: 

$ діі іад -з <имя-метки> 



соге.ехсІисІеяШе Чтобы Сіг не видел определённые файлы проекта как неотслеживаемые и 
не пытался добавить их в индекс при выполнении діі. абб, можно задать для них шаблоны 
в файл . діііідпоге, как это описано Главе 2. Однако, если вам необходим другой файл, 
который будет хранить эти или дополнительные значения вне вашего проекта, то вы можете 
указать СіГурасположениетакогофайласпомощьюнастройкисоге . ехсіисіез^ііе. Просто 
задайте там путь к файлу, в котором написано то же, что пишется в . діг.ідпоге. 

Ьеір.аиіосоггесі Эта опция доступна только в СіГ 1.6.1 и более поздних. Если вы неправильно 
наберёте команду в Сіі 1.6, он выдаст что-то вроде этого: 

$ діі сот 

діг. : 'сот' із поі а ді1:-соттапсІ . 5ее 'діГ. --Иеір 1 . 

Оісі уои теап Ыііз? 
соттіі: 



Если установить Не1р.аиг.осоггес1:в1, Сіг автоматически запустит нужную команду, 
если она была единственным вариантом при этом сценарии. 

7.1.2 Цвета в Сіі 

СіГ умеет раскрашивать свой вывод для терминала, что может помочь вам быстрее и легче 
визуально анализировать вывод. Множество опций в настройках помогут вам установить 
цвета в соответствии со своими предпочтениями. 

соіог.иі СіГ автоматически раскрасит большую часть своего вывода, если вы его об этом 
попросите. Вы можете очень тонко задать, что вы хотите раскрасить и как. Но, чтобы просто 
включить весь предустановленный цветной вывод для терминала, установите соіог . иі в 
Ігие: 

$ діі согтРід --дІоЬаІ соіог.иі ігие 

Когда установлено это значение, СіГ раскрашивает свой вывод в случае, если вывод идёт 
на терминал. Другие доступные значения это: Ыве, при котором вывод никогда не раскрашивается, 
и аЬгаув, при котором цвета добавляются всегда, даже если вы перенаправляете вывод команд 
СіІ'а в файл или через конвейер другой команде. Эта настройка появилась в СіІ версии 1.5.5; 
если у вас версия старее, вам придётся задать каждую настройку для цвета отдельно. 
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Вам вряд ли понадобится использовать соіог . иі = аіиауз. В большинстве случаев, 
если вам нужны коды цветов в перенаправленном выводе, то вы можете просто передать команде 
флаг - -соіог, чтобы заставить её добавить коды цветов. Настройка соіог . иі = 1:гие — 
это почти всегда именно то, что вам нужно. 

СОІОГ . * Если вам необходимо более точно задать какие команды и как должны быть раскрашены, 
или если вы используете старую версию, то в Сіі есть возможность задать настройки цветов 
для каждой команды отдельно. Каждая из этих настроек может быть установлена в {.гие, 
■раізе или аімауз: 

соіог . Ьгапсгі 
соіог . йІТТ 
соіог . ігтЬегасііѵе 
соіог . 5(:аг.и5 

Кроме того, каждая из этих настроек имеет свои поднастройки, которые можно использовать 
для задания определённого цвета для какой-то части вывода, если вы хотите перезадать цвета. 
Например, чтобы получить мета-информацию в выводе команды йііі в синем цвете с чёрным 
фоном и жирным шрифтом, выполните 

$ д±1 согтГід --дІоЬаІ соІог.сІі^гТ.тег.а "Ыие Ыаск Ьоіа"' 

Цвет может принимать любое из следующих значений: погтаі, Ыаск, геа, §гееп, уеііош, 
Ыие, та§епіа, суап и \ѵЬііе. Если вы хотите задать атрибут вроде ЬоЫ, как мы делали в предыдущем 
примере, то на выбор представлены: ЬоЫ, аіт, иі, Ыіпк и геѵегзе. 

Если вам это интересно, загляните в страницу руководства для діі. согтРід, чтобы 
узнать о всех доступных для конфигурации настройках. 

7.1.3 Внешние утилиты тег§е и дііі 

Хоть в Сіі и есть внутренняя реализация аій, которой мы и пользовались до этого момента, 
вы можете заменить её внешней утилитой. И ещё вы можете установить графическую утилиту 
для разрешения конфликтов слияния, вместо того, чтобы разрешать конфликты вручную. Мы 
рассмотрим настройку Регіогсе Ѵівиаі Мег§е Тооі (Р4Мег§е) в качестве замены аій и для разрешения 
конфликтов слияния, потому что это удобная графическая утилита и к тому же бесплатная. 

Если вам захотелось её попробовать, то Р4Мег§е работает на всех основных платформах, 
поэтому проблем с ней быть не должно. В примерах мы будем использовать пути к файлам, 
которые используются на Мае и Ьіпих; для \Ѵіпс1о\ѵ5 вам надо заменить /изг/ІосаІ/Ьіп на 
тот путь к исполняемым файлам, который используется в вашей среде. 

Скачать Р4Мег§е можно здесь: 

пг.г.р : / Уйми. регТогсе . сот/рег^огсе/сіоипіоасіз/сотропепі: . И1:т1 
Для начала сделаем внешние сценарии-обёртки для запуска нужных команд. Я буду использовать 
Мас'овский путь к исполняемым файлам; для других систем это будет тот путь, куда установлен 
ваш файл р4шегде. Сделайте для слияния сценарий-обёртку с именем ех1:Мегде, он будет 
вызывать бинарник со всеми переданными аргументами: 
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$ саг. /изг/1оса1/Ьіп/ех1:Мегде 
#!/Ьіп/зп 

/Арр1ісат.іопз/р4тегде . арр/Сопг.епг.з/Мас05/р4тегде $* 

Обёртка для аіЯ проверяет, что ей было передано семь аргументов, и передаёт два из них 
вашему сценарию для слияния. По умолчанию СіІ передаёт следующие аргументы программе 
выполняющей аіЯ: 

путь старый-файл старый-хеш старые-права новый-файл новый-хеш новые-права 



Так как нам нужны только старый -файл и новый-файл, воспользуемся сценарием- 
обёрткой, чтобы передать только те аргументы, которые нам нужны: 



$ саг. /изг/ІосаІ/Ып/ехг.ОігТ 




#!/Ьіп/зп 




[ $# -ед 7 ] && /изг/1оса1/Ьіп/ехг.Мегде "$2" "$5" 





Ещё следует убедиться, что наши сценарии имеют права на исполнение: 



$ зисіо сптосі +х /изг/ІосаІ/Ьіп/ехіМегде 
$ зисіо сптосі +х /изг/1оса1/Ьіп/ехг.0ітТ 



Теперь мы можем настроить свой конфигурационный файл на использование наших собственных 
утилит для разрешения слияний и аіЯ 'а. Для этого нам потребуется поменять несколько настроек: 
те где . іооі, чтобы указать Сіі'у на то, какую стратегию использовать; шегдеііооі.*. ста 1 , 
чтобы указать как запустить команду; тегдеіооі. ішзіЕхііСосІе, чтобы указать СИ'у, 
можно ли по коду возврата определить, было разрешение конфликта слияния успешным или 
нет; исИ'Г'Г . ех1:егпа1длятого,чтобызадатькомандуиспользуемуюдлясіій. Таким образом 
вам надо либо выполнить четыре команды діі: согтРід 

$ діг. соп'Пд --дІоЬаІ тегде.1:оо1 ехт.Мегде 

$ діі соп1"ід --дІоЬаІ тегдет.оо1 . ехіМегде . стсі \ 

'ехіМегде "$ВА5Е" "$ШСАЬ" "$РЕМОТЕ" "$МЕРСЕ0"' 
$ діт: соп1"ід --дІоЬаІ шегде1:оо1 . ігиз1:Ехі1:СосІе ■раізе 
$ дхі соп1"ід --дІоЬаІ сИ'Г'Г . ехіегпаі ехЮі^^ 



либо отредактировать свой файл ~/ . діІісогтГід и добавить туда следующие строки: 



[тегде] 
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1:оо1 = ехг.Мегде 
[шегдеіооі "ехг.Мегде"] 

стсі = ехИМегде "$ВА5Е" "$ЬОСАЬ" "$КЕМОТЕ" "$МЕК6Е0" 

1:ги5Г.Ехіг.СосІе = ^аізе 
[сіігг] 

ехіегпаі = ехІіОітТ 

Если после того, как всё это настроено, вы выполните команду йііі следующим образом: 

$ діі СІІтт 32СІ1776ЫЛ 32СІ1776Ы 

то вместо того, чтобы получить вывод команды йііі в терминал, Сіі запустит Р4Мег§е, как 
это показано на Рисунке 7-1. 
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7.1 


Р4Мегде. 



Если при попытке слияния двух веток вы получите конфликт, запустите команду діі. 
тегдеііооі — она запустит графическую утилиту Р4Мег§е, с помощью которой вы сможете 
разрешить свои конфликты. 

Что удобно в нашей настройке с обёртками, так это то, что вы с лёгкостью можете поменять 
утилиты для слияния и шЯ 'а. Например, чтобы изменить свои утилиты ехІіОІІ^ иех1:Мегде 
так, чтобы они использовали утилиту КХИЯЗ, всё, что вам надо сделать, это отредактировать 
свой файл ех1:Мегде: 

$ саі /и5г/1оса1/Ьіп/ехг.Мегде 
#!/Ьіп/зг, 

/Арр1ісаг.іоп5/ксІігТЗ . арр/СопІепІз/МасОЗ/ксіігТЗ $* 

Теперь СіІ будет использовать утилиту КЮіЯЗ для просмотра саЯ'ов и разрешения конфликтов 
слияния. 

В Сіі уже есть предустановленные настройки для множества других утилит для разрешения 
слияний, для которых вам не надо полностью прописывать команду для запуска, а достаточно 
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просто указать имя утилиты. К таким утилитам относятся: каійЗ, орепаій, ГксИй, теЫ, ххаій, 
етег§е, ѵітсіій и §ѵітаій. Например, если вам не интересно использовать КЕ)ійЗ для аій'ов, 
а хочется использовать его только для разрешения слияний, и команда каійЗ находится в пути, 
то вы можете выполнить 

$ діі согтГід --дІоЬаІ тегде.іооі ксіітТЗ 



Если вместо настройки файлов ех1:Мегде и ех1:0ігТ вы выполните эту команду, Сіт 
будет использовать КЕ)ійЗ для разрешения слияний и обычный свой инструмент сіій для сИй'ов. 

7.1.4 Форматирование и пробельные символы 

Проблемы с форматированием и пробельными символами — одни из самых дурацких и 
трудно уловимых проблем из тех, с которыми сталкиваются многие разработчики при совместной 
работе над проектами, особенно если разработка ведётся на разных платформах. Очень просто 
внести малозаметные изменения с помощью пробельных символов при, например, подготовке 
патчей из-за того, что текстовые редакторы добавляют их без предупреждения, или в кросс- 
платформенных проектах \Ѵіпсіо\ѵ5-программисты добавляют символы возврата каретки в конце 
изменяемых ими строк. В Сіг есть несколько опций для того, чтобы помочь с решением подобных 
проблем. 

соге.аиіосгіі Если вы пишите код на ѴѴіпсіошв или пользуетесь другой системой, но работаете 
с людьми, которые пишут на ѴѴіпсіо\ѵ5, то наверняка рано или поздно столкнётесь с проблемой 
конца строк. Она возникает из-за того, что ѴѴіпао\ѵ5 использует для переноса строк и символ 
возврата каретки, и символ перехода на новую строку, в то время как в системах Мае и Ьіпігх 
используется только символ перехода на новую строку. Это незначительное, но невероятно 
раздражающее обстоятельство при кросс-платформенной работе. 

Сіі может справиться с этим, автоматически конвертируя СКЕР-концы строк в ЬР при 
коммите и в обратную сторону при выгрузке кода из репозитория на файловую систему. Данную 
функциональность можно включить с помощью настройки соге . аиіосгі^. Если вы используете 
\Ѵіпсіош5, установите настройку в іше, тогда концы строк из ЬР будут сконвертированы в 
СКЕР при выгрузке кода: 

$ діі согтГід --дІоЬаІ соге . аиіосгіт' г.ше 



Если вы сидите на Ьіпих или Мае, где используются ЬР-концы строк, вам не надо, чтобы 
СіІ автоматически конвертировал их при выгрузке файлов из репозитория. Однако, если вдруг 
случайно кто-то добавил файл с СКЕР-концами строк, то хотелось бы, чтобы СіІ исправил 
это. Можно указать СіІ'у, чтобы он конвертировал СКЕР в ЕР только при коммитах, установив 
настройку соге . аиііосгіг' в іприі:: 

$ діі соітРід --дІоЬаІ соге . аиіосгі-р іприГ. 
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Такая настройка даст вам СКІР-концы в выгруженном коде на ѴУіпс1о\ѵ5-системах и ЬР- 
концы на Мас'ах и Ыгшх, и в репозитории. 

Если вы \Ѵіпс1о\ѵ5-программист, пишущий проект, предназначенный только для \Ѵіпао\ѵ5, 
то можете отключить данную функциональность и записывать символы возврата каретки в 
репозиторий, установив значение настройки в г"аІ5е: 

$ діі сопГід --дІоЬаІ соге . аиіосгІГ Гаізе 



соге.ѵѵЬкезрасе СіІ заранее настроен на обнаружение и исправление некоторых проблем, 
связанных с пробелами. Он может находить четыре основные проблемы с пробелами — две 
из них по умолчанию отслеживаются, но могут быть выключены, и две по умолчанию не 
отслеживаются, но их можно включить. 

Те две настройки, которые включены по умолчанию — это 1:гаі1іпд - зрасе, которая 
ищет пробелы в конце строк, и 5 расе - Ье'Гоге - 1:аЬ, которая ищет пробелы перед символами 
табуляции в начале строк. 

Те две, которые по умолчанию выключены, но могут быть включены — это іпсіепі:- 
- поп - 1:аЬ, которая ищет строки начинающиеся с восьми или более пробелов вместо 
символов табуляции, и сг - - еоі, которая сообщает СИ'у, что символы возврата каретки в 
конце строк допустимы. 

Вы можете указать Сіг 'у, какие из этих настроек вы хотите включить, задав их в со г е . ипіііезрасе 
через запятую. Отключить настройку можно либо опустив её в списке, либо дописав знак 
- перед соответствующим значением. Например, если вы хотите установить все проверки, 
кроме сг - - еоі, то это можно сделать так: 

$ діі сопГід --дІоЬаІ соге .иИНезрасе \ 

Ьгаіііпд-зрасе, зрасе-ЬеГоге-іаЬ, іпсіегі(:-\л/і1:гі-поп-(:аЬ 



Сй будет выявлять эти проблемы при запуске команды діі СІІгТ и пытаться выделить 
их цветом так, чтобы можно было их исправить ещё до коммита. Кроме того, эти значения 
будут использоваться, чтобы помочь с применением патчей с помощью діі арріу. Когда 
будете принимать патч, можете попросить СіГ предупредить вас о наличии в патче заданных 
проблем с пробельными символами: 

$ діі арріу - -\л/Ні1:е5расе=магп <патч> 



Или же СіГ может попытаться автоматически исправить проблему перед применением 
патча: 

$ діі арріу - -мгіі1:езрасе=Гіх <патч> 
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Данные настройки также относятся и к команде діі геЬазе. Если вы вдруг сделали 
коммиты, в которых есть проблемы с пробельными символами, но ещё не отправили их на 
сервер, запустите геЬазе с опцией - -иНІІіезрасе^іх, чтобы Сіг автоматически исправил 
ошибки во время переписывания патчей. 

7.1.5 Настройка сервера 

Для серверной части СіГ доступно не так уж много настроек, но среди них есть несколько 
интересных, на которые следует обратить внимание. 

гесеіѵе.{8скОЬ]есі8 По умолчанию Ск не проверяет все отправленные на сервер объекты на 
целостность. Хотя СіІ и может проверять, что каждый объект всё ещё совпадает со своей 
контрольной суммой 5НА-1 и указывает на допустимые объекты, по умолчанию СіГ не делает 
этого при каждом запуске команды р и 5 И . Эта операция довольно затратна и может значительно 
увеличить время выполнения діі риз И в зависимости от размера репозитория и количества 
отправляемых данных. Если вы хотите, чтобы СіГ проверял целостность объектов при каждой 
отправке данных, сделать это можно установив гесеіѵе . ^зскОг^ есііз в Ггае: 



$ діі соп-рід --зузіет гесеіѵе . ■рзскОЬзесг.з ігие 




Теперь Сіі, перед тем как принять новые данные от клиента, будет проверять целостность 
вашего репозитория, чтобы убедиться, что какой-нибудь неисправный клиент не внёс повреждённые 
данные. 

гесеіѵе.сІепуІѴопРаяіРогѵѵагсІя Если вы переместили с помощью команды геЬазе уже отправленные 
на сервер коммиты, и затем пытаетесь отправить их снова, или, иначе, пытаетесь отправить 
коммит в такую удалённую ветку, которая не содержит коммит, на который на текущий момент 
указывает удалённая ветка — вам будет в этом отказано. Обычно это хорошая стратегия. Но 
в случае если вы переместили коммиты, хорошо понимая зачем это вам нужно, вы можете 
вынудить Сіі обновить удалённую ветку передав команде риз И флаг - Т. 

Чтобы отключить возможность принудительного обновления веток, задайте гесеіѵе . сІепуМопРа5І:Ропл/агсІ 

$ діі соп-рід --зузГ.ет гесеіѵе . сІепуМопРаз1:Роі-иагсІз Г.гие 



Есть ещё один способ сделать это — с помощью перехватчиков, работающих на приём 
(гесеіѵе Ьоокв), на стороне сервера, которые мы рассмотрим вкратце позднее. Такой подход 
позволит сделать более сложные вещи, такие как, например, запрет принудительных обновлений 
только для определённой группы пользователей. 

гесеіѵе.сіепуВеІеіез Один из способов обойти политику сІепуМопРа5І:Ропл/агсІ5 — это 

удалить ветку, а затем отправить новую ссылку на её место. В новых версиях Ск'а (начиная с 
версии 1.6.1) вы можете установить гесеіѵе . сІепуОеІеІіез в пне: 
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Этим вы запретите удаление веток и меток с помощью команды р и 5 И для всех сразу — ни 
один из пользователей не сможет этого сделать. Чтобы удалить ветку на сервере, вам придётся 
удалить файлы ссылок с сервера вручную. Также есть и другие более интересные способы 
добиться этого, но уже для отдельных пользователей с помощью АСЬ (списков контроля доступа), 
как мы увидим в конце этой главы. 

7.2 Сіі-атрибуты 

Некоторые настройки могут быть заданы для отдельных путей, и тогда СіГ будет применять 
их только для некоторых подкаталогов или набора файлов. Такие настройки специфичные по 
отношению к путям называются атрибутами и задаются либо в файле .дІг.аг_г.ГІЬііг.е5 в 
одном из каталогов проекта (обычно в корне) или в файле . дІг./ІПт"о/аг.г.ГІЬиг.е5, если 
вы не хотите, чтобы файл с атрибутами попал в коммит вместе с остальными файлами проекта. 

Использование атрибутов позволяет, например, задать разные стратегии слияния для отдельных 
файлов или каталогов проекта, или объяснить СіІ'у, как сравнивать нетекстовые файлы, или 
сделать так, чтобы СіГ пропускал данные через фильтр перед тем, как выгрузить или записать 
данные в репозиторий. В этом разделе мы рассмотрим некоторые из доступных в СіГ'е атрибутов 
и рассмотрим несколько практических примеров их использования. 

7.2.1 Бинарные файлы 

Есть один клёвый трюк, для которого можно использовать атрибуты — можно указать 
Ск'у, какие файлы являются бинарными (в случае если по-другому определить это не получается), 
и дать ему специальные инструкции о том, как с этими файлами работать. Например, некоторые 
текстовые файлы могут быть машинными — генерируемыми программой — для них нет смысла 
вычислять дельты, в то время как для некоторых бинарных файлов получение дельт может 
быть полезным. Дальше мы увидим, как сказать СіІ'у, какие файлы какие. 

Определение бинарных файлов Некоторые файлы выглядят как текстовые, но по существу 
должны рассматриваться как бинарные данные. Например, проекты Хсосіе на Мас'ах содержат 
файл, оканчивающийся на . рЬхргс^ , который по сути является набором ІЗСШ-данных (текстовый 
формат данных для іаѵазсгірі), записываемым ГОЕ, в котором сохраняются ваши настройки 
сборки и прочее. Хоть технически это и текстовый файл, потому что содержит только А5СІІ- 
символы, но нет смысла рассматривать его как таковой, потому что на самом деле это легковесная 
база данных — вы не сможете слить её содержимое, если два человека внесут в неё изменение, 
получение дельт тоже, как правило, ничем вам не поможет. Этот файл предназначается для 
обработки программой. По сути, лучше рассматривать этот файл как бинарный. 

Чтобы заставить СіГ обращаться со всеми рЬхргс^ файлами как с бинарными, добавьте 
следующую строку в файл . діг_аг.г.гіЬиг.е5: 

*.рЬхргоз -сгІ-Г -сіі-р-р 
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Теперь С-К не будет пытаться конвертировать СКЕР-концы строк или исправлять проблемы 
с ними. Также он не будет пытаться получить дельту для изменений в этом файле при запуске 
діі. зНои или діі: сИ'Р'Р в вашем проекте. Начиная с версии 1.6 в С-іі есть макрос, который 
означает то же, что и - с г 1Т -сИ'Г'Г: 

*.рЬхргоз Ьіпагу 



Получение дельты для бинарных файлов В Сіі версии 1.6.x функциональность атрибутов 
может быть использована для эффективного получения дельт для бинарных файлов. Чтобы 
сделать это, нужно объяснить СіІ'у, как сконвертировать ваши бинарные данные в текстовый 
формат, для которого можно выполнить сравнение с помощью обычного аіЯ. 

Документы М8 ѴѴогсІ Так как эта довольно клёвая функция не особо широко известна, мы 
рассмотрим несколько примеров её использования. Для начала мы используем этот подход, 
чтобы решить одну из самых раздражающих проблем известных человечеству: версионный 
контроль документов \Ѵогсі. Всем известно, что \Ѵогсі это самый ужасающий из всех существующих 
редакторов, но, как ни странно, все им пользуются. Если вы хотите поместить документы \Ѵога 
под версионный контроль, вы можете запихнуть их в С-К-репозиторий и время от времени 
делать коммиты. Но что в этом хорошего? Если вы запустите діі сіігТ как обычно, то 
увидите только что-то наподобие этого: 

$ діі сіггТ 

сіігТ --діг. а/сНарІегІ.сІос Ь/сМаріегІ.сІос 
ІПСІех 88839С4. .4агсЬ7с 100644 

Віпагу -рііез а/сМаріегІ.сіос апсі Ь/сИар1:ег1 . сіос сІі-гТег 



У вас не получится сравнить две версии между собой, только если вы не выгрузите их 
обе и просмотрите их вручную, так? Оказывается, можно сделать это достаточно успешно, 
используя атрибуты С-іг. Поместите следующую строку в свой файл . діг.аг.г.гіЬиг.ез: 



*.сіос с)ігТ=\люгсі 




Она говорит ОС у, что все файлы, соответствующие указанному шаблону (.сіос) должны 
использовать фильтр «\ѵогсі» при попытке посмотреть дельту с изменениями. Что такое фильтр 
«\ѵогсі»? Нам нужно его изготовить. Сейчас мы настроим С-іГ на использование программы 
зіігіпдз для конвертирования документов Ѵѵога в читаемые текстовые файлы, которые С-іг 
затем правильно сравнит: 



$ діі согтРід біТТ .могсі . іехісопѵ зігіпдз 




Этой командой в свой . діі/ согтГід вы добавите следующую секцию: 
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[СІІГ-Р "йога 1 "] 
1:ех1:сопѵ = зіігіпдз 



Замечание: Существуют разные виды .сіосфайлов. Некоторые из них могут использовать 
кодировку ШТ-16 или могут быть написаны не в латинице, в таких файлах зіігіпдзне найдёт 
ничего хорошего. Полезность зіігіпдз может сильно варьироваться. 

Теперь Сіі знает, что если ему надо найти дельту между двумя снимками состояния, и 
какие-то их файлы заканчиваются на . СІОС, он должен прогнать эти файлы через фильтр «\ѵогсі», 
который определён как программа зіігіпдз. Так вы фактически сделаете текстовые версии 
своих ѴѴогсі-файлов перед тем, как получить для них дельту. 

Рассмотрим пример. Я поместил Главу 1 настоящей книги в С-іГ, добавил немного текста 
в один параграф и сохранил документ. Затем я выполнил діі СІІгТ, чтобы увидеть, что 
изменилось: 

$ діи сіітТ 

діТТ --діі: а/сИаріегІ.сІос Ь/сИаріегІ.сіос 
іпсіех сІсваѲа. . Ь93с9е4 1ѲѲ644 
— а/сИар1:ег1 . сіос 
+++ Ь/сИар1:ег1 . сіос 

@@ -8,7 +8,8 і§ ге доіпд Іо соѵег Ѵегзіоп Сопігоі ЗузГетз (ѴС5) апсі біі Ьазісз 
ге доіпд Ьо соѵег Пои іо деі іі апа 1 зеі 11 ир ■Тог ІИе ^ігзі ііте ІТ уои сіоп 
1: аігеасіу Иаѵе іі оп уоиг зузііет. 

Іп СПар1:ег Тио ие мііі до оѵег Ьазіс бИ изаде - Пои 1:о изе біі: 'Тог ІИе 80% 
-з доіпд оп, тосіі-ру зіи-Г-Г апсі соп(:гіЬи1:е сИапдез. 11" Ыіе Ьоок зропііапеоизіу 
+з доіпд оп, тосіі-ру зіи-р-р апсі соп(:гіЬи1:е сИапдез. 11" Ыіе Ьоок зроп1:апеоиз1у 
+І_е1: | 5 зее І1" іИіз иогкз. 



Сіт коротко и ясно дал мне знать, что я добавил строку «ЬеГв зее іі иііз \ѵогкв», так оно 
и есть. Работает не идеально, так как добавляет немного лишнего в конце, но определённо 
работает. Если вы сможете найти или написать хорошо работающую программу для конвертации 
документов ѴѴогсі в обычный текст, то такое решение скорее всего будет невероятно эффективно. 
Тем не менее, зіігіпдз доступен на большинстве Мае и Ілгшх-систем, так что он может 
быть хорошим первым вариантом для того, чтобы сделать подобное со многими бинарными 
форматами. 

Текстовые файлы в формате ОреіШосшпепі Тот же подход, который мы использовали для 
файлов М5 \Ѵогсі (* . СІОС), может быть использован и для текстовых файлов в формате Ореп- 
Восшпепг, созданных в ОрепОШсе.ог§. 

Добавим следующую строку в файл . ді1:а1:1:гіЬи1:е5: 

*.осІ1: сіггт^осіі: 



Теперь настроим фильтр обі. в . діІі/согтРід: 
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[сИгТ "ойѴ] 
Ьіпагу = Г.гие 

т.ехг.сопѵ = /изг71оса1/Ьіп/осІ1:-1:о-Г.хГ. 




Файлы в формате ОрепОосшпеШ: на самом деле являются запакованными 2Ір'ом каталогами 
с множеством файлов (содержимое в ХМЬ-формате, таблицы стилей, изображения и т.д.). 
Мы напишем сценарий для извлечения содержимого и вывода его в виде обычного текста. 
Создайте файл /и5г/1оса1/Ьіп/осІ1:-1:о-1:х1: (можете создать его в любом другом каталоге) 
со следующим содержимым: 



#! /изг/Ьіп/епѵ регі 

# Сценарий для конвертации ОрегЮоситепт. Техг. (.осЛ:) в обычный текст. 

# Автор: Рпііірр Кетрдеп 



±Т (! сІе-ГіпесЦЗАКбѴСѲ])) { 

ргіпг. 5ЮЕКК "Не задано имя файла !\п"; 

ргіпг. 5ЮЕКР "Использование: $0 имя файлаЧп"; 

ехіі 1; 

} 



'ипгір', '-рр', '-р', $АК6Ѵ[Ѳ], ' сопИепі .хті' ог сііе $!; 
# считываем файл целиком 



ту $сопіеп1: = ' 1 ; 
ореп ту $-Гп, ' - 1 ' , 
{ 

Іосаі $/ = ипсіе-Г; 
$сопг.епг_ = <$-Гп>; 
} 

сіозе $-рп; 

$_ = $соп1:еп1:; 

з/<іехі : зрап\Ь[ л >] *>//д; # удаляем зрап'ы 

з/<1:ех(: : п\Ь[ Л >] *>/\п\п***** /д; # заголовки 
з/<іех(: :1із1:-і1:ет\Ь[л>] *>\з*<іехС : р\Ь[л>] *>/\п 



/д; # элементы списков 



з/<іехС : 1із1:\Ь [л>] *>/\п\п/д ; 
5/<г.ехі:р\Ь[л>]*>/\п /д; 
з/<[ Л >]+>//д; 
з/\п{2, }/\п\п/д; 
з/\А\п+//; 

ргіпі "\п", $_, "\п\п"; 



# списки 

# параграфы 

# удаляем все ХМІ_-теги 

# удаляем подряд идущие пустые строки 

# удаляем пустые строки в начале 



Сделайте его исполняемым 



сптосі +х /изг/ІосаІ/Ьіп/осИі-Ііо-Ііхі 



Теперь діі. сИ'Г'Г сможет сказать вам, что изменилось в . обі. файлах. 



Изображения Ещё одна интересная проблема, которую можно решить таким способом, это 
сравнение файлов изображений. Один из способов сделать это — прогнать РІЧС-файлы через 
фильтр, извлекающий их ЕХІР-информацию — метаданные, которые дописываются в большинство 
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форматов изображений. Если скачаете и установите программу ехіт"іоо1, то сможете воспользоваться 
ею, чтобы извлечь из изображений текстовую информацию о метаданных, так чтобы аіЯ хоть 
как-то показал вам текстовое представление произошедших изменений: 

$ еспо ' * . рпд с)і'Г'Г=ехіТ ' » . длЛа^гіЬиЬез 
$ діі согтГід сІі^.ехіІМіехІісопѵ ехіІЧооІ 



Если вы замените в проекте изображение и запустите діг. сИ'Г'Г, то получите что-то 
вроде такого: 



діТТ --діі: а/ітаде.рпд Ь/ітаде 


рпд 






ІПСІех 88839С4. .4агсЬ7с 1Ѳ0644 










— а/ітаде.рпд 










+++ Ь/ітаде.рпд 










і§ -1,12 +1,12 §§ 










Ехі^ТооІ Ѵегзіоп МитЬег 




7.74 






-Рііе 5І2Ѳ 




7Ѳ кв 






-Рііе МосЛ'Гл.саПоп Оаіе/Тіте 




2009:04:21 07:02 


45-07 


00 


+Рі1е 5іге 




94 кВ 






+Рі1е МосИ'Гл.саПоп Оаіе/Тіте 




2009:04:21 07:02 


43-07 


00 


Рііе Туре 




РМ6 






МІМЕ Туре 




ітаде/рпд 






-Ітаде ЫісЛіИ 




1058 






-Ітаде Неідпі: 




889 






+Ітаде Ыісі1:М 




1056 






+Ітаде Неідпі: 




827 






ВіИ ЭерИп 




8 






Соіог Туре 




Р6В иііп Аірпа 







Легко можно заметить, что размер файла, а также высота и ширина изображения поменялись. 

7.2.2 Развёртывание ключа 

Разработчики, привыкшие к 5 ѴМ или СѴ5, часто хотят получить в СіГ возможность развёртывания 
ключа в стиле этих систем. Основная проблема с реализацией этой функциональности в СіГ это 
то, что нельзя записать в файл информацию о коммите после того, как коммит был сделан, так 
как СіГ сначала считает контрольную сумму для файла. Не смотря на это, вы можете вставлять 
текст в файл во время его выгрузки и удалять его перед добавлением в коммит. Атрибуты СіГ 
предлагают два варианта сделать это. 

Во-первых, вы можете внедрять 5НА-1-сумму блоба в поле $ІСІ$ в файл автоматически. 
Если установить соответствующий атрибут для одного или нескольких файлов, то в следующий 
раз, когда вы будете выгружать данные из этой ветки, СіГ будет заменять это поле 5НА-суммой 
блоба. Обратите внимание, что это 5НА-1 не коммита, а самого блоба. 

$ еспо ' * . 1:х1: ісіепі' » . діІіаІІгіЬиІіез 
$ еспо '$Іс1$' > ИезССхИ 
$ діі асісі Ііезі . Ьхі: 
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В следующий раз, когда вы будете выгружать этот файл, Сіі автоматически вставит в него 
5НА его блоба: 

$ гт Іезі .1:х1: 

$ діі сЬескоиг. -- ЬезІ.іхЕ 
$ саі іезИхІ: 

$ІС): 42812Ь7653с7Ь88933-Г8а9сІ6сасІѲса16714Ь9ЬЬЗ $ 

Однако, такой результат мало применим. Если вы раньше пользовались развёртыванием 
ключа в СѴ5 или ЗиЬѵегвіоп, можете добавлять метку даты — 5НА не особенно полезен, так 
как он довольно случаен, и к тому же, глядя на две 5НА-суммы, никак не определить какая из 
них новее. 

Как оказывается, можно написать свои собственные фильтры, которые будут делать подстановки 
в файлах при коммитах и выгрузке файлов. Для этого надо задать фильтры «сіеап» и «5ітшс1§е». 
В файле . дІІаІІГІЬіІІіез можно задать фильтр для определённых путей и затем установить 
сценарии, которые будут обрабатывать файлы непосредственно перед выгрузкой («5ітша§е», 
смотри Рисунок 7-2) и прямо перед коммитом («сіеап», смотри Рисунок 7-3). Эти фильтры 
можно настроить на совершение абсолютно любых действий. 



Зіадіпд Агеа ѴѴогкіпд Оігесіогу 







Мхі Ріііег 






ЛІеА.М 










ЯІвА.Ьй' 






зтийде — 
















«ІеВ.ІхІ 






сіеап 


(ІІсВ.ІхС 













ЛІеС.гЬ 




(ІІеС.гЬ 





діѣ сгіескоиѣ 

Рисунок 7.2: Фильтр «зтийде» выполняется при скескоиі. 



Зіадіпд Агеа ѴѴогкіпд Оігесіогу 







Мхі Ріііег 




ЯІвА.йЛ 






втигіде 






ЛІеА.іхС 






г 




(ІІеВ.ІхІ 












ШеВ.іхІ' 






сіеап 















ЛІеС.гЬ 




ЛІеС.гЬ 





діѣ асісі 

Рисунок 7.3: Фильтр «сіеап» выполняется при помещении файлов в индекс. 

В сообщении первоначального коммита, добавляющего эту функциональность, дан простой 
пример того, как можно пропустить весь свой исходный код на С через программу іпсіепі: 
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перед коммитом. Сделать это можно, задав атрибут Шіег в файле . дІг.аг_г.ГІЬиг_Ѳ5 так, 
чтобы он пропускал файлы * . с через фильтр «іпаепі»: 

*.с ^І11:ег=іпсіеп1: 



Затем укажите СіІ'у, что должен делать фильтр «іпаепГ» при 5ігша§е и сіеап: 



$ діь 


согтГід 


--дІоЬаІ -Гі11:ег 


, іпсіепі 


, сіеап іпсіепі: 


$ діі 


согтГід 


--дІоЬаІ -Гі11:ег 


. іпсіепі: , 


, зітшсіде саі 



В нашем случае, когда вы будете делать коммит, содержащий файлы, соответствующие 
шаблону * . с, Сіі прогонит их через программу іпсіепі: перед коммитом, а потом через программу 
саі: перед тем как выгрузить их на диск. Программа саі: по сути является холостой — она 
выдаёт те же данные, которые получила. Фактически эта комбинация профильтровывает все 
файлы с исходным кодом на С через іпсіепі: перед тем, как сделать коммит. 

Ещё один интересный пример — это развёртывание ключа $0а1:е$ в стиле КС5. Чтобы 
сделать его правильно, нам понадобится небольшой сценарий, который принимает на вход имя 
файла, определяет дату последнего коммита в проекте и вставляет эту дату в наш файл. Вот 
небольшой сценарий на КиЬу, который делает именно это: 



#! /изг/Ьіп/епѵ гиЬу 




йаіа = ЗЮІМ.геасІ 




1аз1:_сіа(:е = "діі: Іод - -рге(:(:у=1 = огта1: : 


"%а<Г -Г 


риСз сІаСа.дзиЬ( '$ОаЬе$' , '$0а1е: 1 + 


1аз1:_сіа1:е. іо_з + '$' ) 



Всё, что делает этот сценарий, это получает дату последнего коммита с помощью команды 
діі. Іод, засовывает её во все строки $0а1:е$, которые видит в бісііп, и выводит результат — 
такое должно быть несложно реализовать на любом удобном вам языке. Давайте назовём 
этот файл ехрапс!_сІа1:е и поместим в путь. Теперь в С-іг'е необходимо настроить фильтр 
(назовём его сіаііег) и указать, что надо использовать фильтр ехрапсі_сІа1:е при выполнении 
5пшсі§е во время выгрузки файлов. Воспользуемся регулярным выражением Регі, чтобы убрать 
изменения при коммите: 



$ 




согтРід Шіег 


, сіа1:ег . зтисіде 


ехрапсі_сіа1:е 


$ 




согтРід Шіег 


, сіа1:ег . сіеап 


'регі -ре "з/\\\$^а1:е[л\\\$]*\\\$/\\\$^а^:е\\\$/ , " 



Этот фрагмент кода на РегГе вырезает всё, что находит в строке $Эа1:е$ так, чтобы 
вернуть всё в начальное состояние. Теперь, когда наш фильтр готов, можете протестировать 
его, создав файл с ключом $0а1:е$ и установив для этого файла С-іг-атрибут, который задействует 
для него новый фильтр: 
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$ ес\г\о '# $0аГ.е$' > сіа1:е_1:ез1: . ІхГ. 

$ есМо ' сіаіе* . Ьхі: 1 = і1(:ег=сіа1:ег 1 » . ді1:а1:1:гіЬи1:ез 



Если мы сейчас добавим эти изменения в коммит и снова выгрузим файл, то мы увидим, 
что ключевое слово было заменено правильно: 

$ діі асісі сіаг.е_1:ез(: . (:х1: . діІіаІІгіЬиІіез 

$ діі соттіі: -т "Тезііпд сіа1:е ехрапзіоп іп біі" 

$ гт с1а^:е_-1:е51: . т:хт: 

$ діі сііескоиг. сіаіе^ез^ . Іхі. 

$ саі сіа1:е_1:езт: . СхС 

# ЗРаіе: Тие Арг 21 07:26:52 2ѲѲ9 -Ѳ7Ѳ0$ 



Как видите, такая техника может быть весьма мощной для настройки проекта под свои 
нужды. Но вы должны быть осторожны, ибо файл . ді1:а1:1:гіЬи1:е5 вы добавите в коммит 
и будете его распространять вместе с проектом, а драйвер (в нашем случае сіаііег) — нет. 
Так что не везде оно будет работать. Когда будете проектировать свои фильтры, постарайтесь 
сделать так, чтобы при возникновении в них ошибки проект не переставал работать правильно. 

7.2.3 Экспорт репозитория 

Ещё атрибуты в СіІ позволяют делать некоторые интересные вещи при экспортировании 
архива с проектом. 

ехроП-щпоге Вы можете попросить СіГ не экспортировать определённые файлы и каталоги 
при создании архива. Если у вас есть подкаталог или файл, который вы не желаете включать 
в архив, но хотите, чтобы в проекте он был, можете установить для такого файла атрибут 
ехрог1:-ідпоге. 

Например, скажем, у вас в подкаталоге І.Ѳ5І./ имеются некоторые тестовые файлы, и 
нет никакого смысла добавлять их в тарбол при экспорте проекта. Тогда добавим следующую 
строку в файл с СіГ-атрибутами: 

Г.ез1:/ ехрогГ-ідпоге 



Теперь, если вы запустите діі аг сИіѵе, чтобы создать тарбол с проектом, этот каталог 
в архив включён не будет. 

ехрогі-8иЬ§1 Ещё одна вещь, которую можно сделать с архивами, — это сделать какую-нибудь 
простую подстановку ключевых слов. СіГ позволяет добавить в любой файл строку вида $Рог - 
ша1::$ с любыми кодами форматирования, доступными в - - рге1:1:у=1 = огта1: (многие из 
этих кодов мы рассматривали в Главе 2). Например, если вам захотелось добавить в проект 
файл с именем І_А5Т_С0ММІТ, в который при запуске діі агсИіѵе будет автоматически 
помещаться дата последнего коммита, то такой файл вы можете сделать следующим образом: 
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$ есЬо Чазі соттіС гіаНе: $Рогтаі :%ссі$' > І_А5Т_С0ММІТ 
$ есНо "І-А5Т_С0ММІТ ехрог1:-зиЬз1:" » . діІіаІіІгіЬиІез 
$ діг. асИ І_А5Т_С0ММІТ .дИаИЫіЬиСез 

$ діг. соттіі: -ат 'асісііпд І_А5Т_С0ММІТ ■Гііе ■Тог агсИіѵез' 



После запуска діі: а г сИіѵе этот файл у вас в архиве будет иметь содержимое следующего 
вида: 

$ саИ І_А5Т_С0ММІТ 

І-азг. соттіГ. сіаНе: $Рогта1::Тие Арг 21 08:38:48 20Ѳ9 -0700$ 



7.2.4 Стратегии слияния 

Атрибуты СіГ могут также быть использованы для того, чтобы попросить СіГ использовать 
другие стратегии слияния для определённых файлов в проекте. Одна очень полезная возможность — 
это сказать СіІ'у, чтобы он не пытался слить некоторые файлы, если для них есть конфликт, а 
просто выбрал ваш вариант, предпочтя его чужому. 

Это полезно в том случае, если ветка в вашем проекте разошлась с исходной, но вам всё же 
хотелось бы иметь возможность слить изменения из неё обратно, проигнорировав некоторые 
файлы. Скажем, у вас есть файл с настройками базы данных, который называется сіаІаЬазе.хтІ, 
и в двух ветках он разный, и вы хотите влить другую свою ветку, не трогая файл с настройками 
базы данных. Задайте атрибут следующим образом: 

сІаг.аЬазе . хті тегде=оигз 



При вливании другой ветки, вместо конфликтов слияния для файла йашЬаве.хтІ, вы увидите 
следующее: 



$ діг. тегде г.оріс 
Аиг.о-тегдіпд сіаг.аЬазе . хті 
Мегде тасіе Ьу гесигзіѵе. 




В данном случае сіаІаЬаке.хтІ остался в том варианте, в каком и был изначально. 

7.3 Перехватчики в Сіі 

Как и во многих других системах управления версиями, в С-іГ есть возможность запускать 
собственные сценарии в те моменты, когда происходят некоторые важные действия. Существуют 
две группы подобных перехватчиков (Ьоок): на стороне клиента и на стороне сервера. Перехватчики 
на стороне клиента предназначены для клиентских операций, таких как создание коммита и 
слияние. Перехватчики на стороне сервера нужны для серверных операций, таких как приём 
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отправленных коммитов. Перехватчики могут быть использованы для выполнения самых различных 
задач. О некоторых из таких задач мы и поговорим. 

7.3.1 Установка перехватчика 

Все перехватчики хранятся в подкаталоге Иоокз в С-іГ-каталоге. В большинстве проектов 
это .дііі/гіоокз. По умолчанию С-іг заполняет этот каталог кучей примеров сценариев, многие 
из которых полезны сами по себе, но кроме того в них задокументированы входные значения 
для каждого из сценариев. Все эти примеры являются сценариями для командной оболочки с 
вкраплениями РегГа, но вообще-то будет работать любой исполняемый сценарий с правильным 
именем — вы можете писать их на КиЬу или Рушоп или на чём-то ещё, что вам нравится. 
В версиях С-іГ'а старше 1.6 эти файлы с примерами перехватчиков оканчиваются на .вагдріе; 
вам надо их переименовать. Для версий С-іг.'а меньше чем 1.6 файлы с примерами имеют 
правильные имена, но не имеют прав на исполнение. 

Чтобы активировать сценарий-перехватчик, положите файл в подкаталог Иоокз в Сіх- 
каталоге, дайте ему правильное имя и права на исполнение. С этого момента он будет вызываться. 
Основные имена перехватчиков мы сейчас рассмотрим. 

7.3.2 Перехватчики на стороне клиента 

Существует множество перехватчиков, работающих на стороне клиента. В этом разделе 
они поделены на перехватчики используемые при работе над коммитами, сценарии используемые 
в процессе работы с электронными письмами и все остальные, работающие на стороне клиента. 

Перехватчики для работы с коммитами Первые четыре перехватчика относятся к процессу 
создания коммита. Перехватчик р г е - соттіі: запускается первым, ещё до того, как вы наберёте 
сообщение коммита. Его используют для проверки снимка состояния перед тем, как сделать 
коммит, чтобы проверить не забыли ли вы что-нибудь, чтобы убедиться, что вы запустили 
тесты, или проверить в коде ещё что-нибудь, что вам нужно. Завершение перехватчика с 
ненулевым кодом прерывает создание коммита, хотя вы можете обойти это с помощью діі. 
соштіі: - - по - ѵег л.'Ру. Можно, например, проверить стиль кодирования (запускать Ііпі или 
что-нибудь аналогичное), проверить наличие пробельных символов в конце строк (перехватчик 
по умолчанию занимается именно этим) или проверить наличие необходимой документации 
для новых методов. 

Перехватчик р г ера г е- сотшіі: -тзд запускается до появления редактора с сообщением 
коммита, но после создания сообщения по умолчанию. Он позволяет отредактировать сообщение 
по умолчанию перед тем, как автор коммита его увидит. У этого перехватчика есть несколько 
опций: путь к файлу, в котором сейчас хранится сообщение коммита, тип коммита и 5НА-1 
коммита (если в коммит вносится правка с помощью діі. сотшіі: - - атепсі). Как правило 
данный перехватчик не представляет пользы для обычных коммитов; он скорее хорош для 
коммитов с автогенерируемыми сообщениями, такими как шаблонные сообщения коммитов, 
коммиты-слияния, уплотнённые коммиты (эдиааЬеа соттік) и коммиты с исправлениями (атепсіеа 
соттій). Данный перехватчик можно использовать в связке с шаблоном для коммита, чтобы 
программно добавлять в него информацию. 

Перехватчик соттіі: -тзд принимает один параметр, и снова это путь к временному 
файлу, содержащему текущее сообщение коммита. Когда сценарий завершается с ненулевым 
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кодом, СіГ прерывает процесс создания коммита. Так что можно использовать его для проверки 
состояния проекта или сообщений коммита перед тем, как его одобрить. В последнем разделе 
главы я продемонстрирую, как использовать данный перехватчик, чтобы проверить, что сообщение 
коммита соответствует требуемому шаблону. 

После того, как весь процесс создания коммита завершён, запускается перехватчик ро 5 1: - 
соштіі:. Он не принимает никаких параметров, но вы с лёгкостью можете получить последний 
коммит, выполнив діі: Іод -1 НЕАО. Как правило, этот сценарий используется для уведомлений 
или чего-то в этом роде. 

Сценарии на стороне клиента, предназначенные для запуска во время работы над коммитами, 
могут быть использованы при осуществлении практически любого типа рабочего процесса. 
Их часто используют, чтобы обеспечить соблюдение определённых стандартов, хотя важно 
отметить, что данные сценарии не передаются при клонировании. Вы можете принудить к 
соблюдению правил на стороне сервера, отвергая присланные коммиты, если они не подчиняются 
некоторым правилам, но использование данных сценариев на клиентской стороне полностью 
зависит только от разработчика. Итак, эти сценарии призваны помочь разработчикам, и это 
обязанность разработчиков установить и сопровождать их, хотя разработчики и имеют возможность 
в любой момент подменить их или модифицировать. 

Перехватчики для работы с е-таіі Для рабочих процессов, основанных на электронной 
почте, есть три специальных клиентских перехватчика. Все они вызываются командой діі: 
аш, так что, если вы не пользуетесь этой командой в процессе своей работы, то можете смело 
переходить к следующему разделу. Если вы принимаете патчи, отправленные по е-таіі и 
подготовленные с помощью діі 'Гогтаі: - ра1:сИ, то некоторые из них могут оказать для 
вас полезными. 

Первый запускаемый перехватчик — это арріураіісгі -тзд. Он принимает один аргумент 
— имя временного файла, содержащего предлагаемое сообщение коммита. С-іГ прерывает 
наложение патча, если сценарий завершается с ненулевым кодом. Это может быть использовано 
для того, чтобы убедиться, что сообщение коммита правильно отформатировано или, чтобы 
нормализовать сообщение, отредактировав его на месте из сценария. 

Следующий перехватчик, запускаемый во время наложения патчей с помощью діі аш — 
это рг е - арріураіісгі. У него нет аргументов, и он запускается после того, как патч наложен, 
поэтому его можно использовать для проверки снимка состояния перед созданием коммита. 
Можно запустить тесты или как-то ещё проверить рабочее дерево с помощью этого сценария. 
Если чего-то не хватает, или тесты не пройдены, выход с ненулевым кодом так же завершает 
сценарий діі: аш без применения патча. 

Последний перехватчик, запускаемый во время работы діі аш — это розг.-арр1ураг.сгі. 
Его можно использовать для уведомления группы или автора патча о том, что вы его применили. 
Этим сценарием процесс наложения патча остановить уже нельзя. 

Другие клиентские перехватчики Перехватчик рге - г еЬазе запускается перед перемещением 
чего-либо, и может остановить процесс перемещения, если завершится с ненулевым кодом. 
Этот перехватчик можно использовать, чтобы запретить перемещение любых уже отправленных 
коммитов. Пример перехватчика рге - геЬазе, устанавливаемый СК'ом, это и делает, хотя он 
предполагает, что ветка, в которой вы публикуете свои изменения, называется пехі. Вам скорее 
всего нужно будет заменить это имя на имя своей публичной стабильной ветки. 
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После успешного выполнения команды д і 1: сНескоиІ:, запускается перехватчик р о 5 1: - 
сИескоиІ:. Его можно использовать для того, чтобы правильно настроить рабочий каталог 
для своей проектной среды. Под этим может подразумеваться, например, перемещение в каталог 
больших бинарных файлов, которые вам не хочется включать под версионный контроль, автоматическое 
генерирование документации или что-то ещё в таком же духе. 

И наконец, перехватчик роз1:-тегде запускается по еле успешного выполнения команды 
шегде. Его можно использовать для восстановления в рабочем дереве данных, которые Сіг 
не может отследить, таких как информация о правах. Этот перехватчик может также проверить 
наличие внешних по отношению к контролируемым СК'ом файлов, которые вам нужно скопировать 
в каталог при изменениях рабочего дерева. 

7.3.3 Перехватчики на стороне сервера 

В дополнение к перехватчикам на стороне клиента вы, как системный администратор, 
можете задействовать пару важных перехватчиков на стороне сервера, чтобы навязать в своём 
проекте правила практически любого вида. Эти сценарии выполняются до и после отправки 
данных на сервер. Рге-перехватчики могут быть в любое время завершены с ненулевым кодом, 
чтобы отклонить присланные данные, а также вывести клиенту обратно сообщение об ошибке. 
Вы можете установить настолько сложные правила приёма данных, насколько захотите. 

рге-гесеіѵе и розі-гесеіѵе Первым сценарий, который выполняется при обработке отправленных 
клиентом данных, — это рге - гесеіѵе. Он принимает на вход из зіаіп список отправленных 
ссылок; если он завершается с ненулевым кодом, ни одна из них не будет принята. Этот 
перехватчик можно использовать, чтобы, например, убедиться, что ни одна из обновлённых 
ссылок не выполняет ничего кроме перемотки, или, чтобы убедиться, что пользователь, запустивший 
д і 1: р и 5 И , имеет права на создание, удаление или изменение для всех файлов модифицируемых 
этим ризЬ'ем. 

Перехватчик розі: - гесеіѵе запускается после того, как весь процесс завершился, и 
может быть использован для обновления других сервисов или уведомления пользователей. 
Он получает на вход из віаіп те же данные, что и перехватчик рге - гесеіѵе. Примерами 
использования могут быть: отправка писем в рассылку, уведомление сервера непрерывной 
интеграции или обновление карточки (гіскег.) в системе отслеживания ошибок — вы можете 
даже анализировать сообщения коммитов, чтобы выяснить, нужно ли открыть, изменить или 
закрыть какие-то карточки. Этот сценарий не сможет остановить процесс приёма данных, но 
клиент не будет отключён до тех пор, пока процесс не завершится; так что будьте осторожны, 
если хотите сделать что-то, что может занять много времени. 

ирііаіе Сценарий ирсіаііе очень похож на сценарий рге - гесеіѵе, за исключением того, 
что он выполняется для каждой ветки, которую отправитель данных пытается обновить. Если 
отправитель пытается обновить несколько веток, то рге - гесеіѵе выполнится только один 
раз, в то время как ирсіаііе выполнится по разу для каждой обновляемой ветки. Сценарий не 
считывает параметры из вісііп, а принимает на вход три аргумента: имя ссылки (ветки), 5НА-1, 
на которую ссылка указывала до запуска ризгі, и тот 5НА-1, который пользователь пытается 
отправить. Если сценарий ирсіаііе завершится с ненулевым кодом, то только одна ссылка 
будет отклонена, остальные ссылки всё ещё смогут быть обновлены. 
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7.4 Пример навязывания политики с помощью Сіі 

В этом разделе мы используем ранее полученные знания для организации в СіГ такого 
рабочего процесса, который проверяет сообщения коммитов на соответствие заданному формату, 
из обновлений разрешает только перемотки и позволяет только определённым пользователям 
изменять определённые подкаталоги внутри проекта. Мы создадим клиентские сценарии, 
которые помогут разработчикам узнать, будет ли их ривЬ отклонён, и серверные сценарии, 
которые будут действительно вынуждать следовать установленным правилам. 

Для их написания я использовал КиЪу, и потому что это мой любимый язык сценариев, и 
потому что из всех языков сценариев он больше всего похож на псевдокод; таким образом, код 
должен быть вам понятен в общих чертах, даже если вы не пользуетесь КиЪу. Однако любой 
язык сгодится. Все примеры перехватчиков, распространяемые вместе с Сіг/ом, написаны 
либо на Регі, либо на ВавЬ, так что вы сможете просмотреть достаточно примеров перехватчиков 
на этих языках, заглянув в примеры. 

7.4.1 Перехватчик на стороне сервера 

Вся работа для сервера будет осуществляться в файле ирсіаііе из каталога Иоокз. Файл 
ирсіаііе запускается по разу для каждой отправленной ветки и принимает на вход ссылку, в 
которую сделано отправление, старую версию, на которой ветка находилась раньше, и новую 
присланную версию. Кроме того, вам будет доступно имя пользователя, приславшего данные, 
если ризИ был выполнен по ЗЗН.Если выпозволили подключаться всем под одним пользователем 
(например, с аутентификацией по открытому ключу, то вам может понадобиться создать 

для этого пользователя обёртку командной оболочки, которая на основе открытого ключа будет 
определять, какой пользователь осуществил подключение, и записывать этого пользователя в 
какой-нибудь переменной окружения. Тут я буду предполагать, что имя подключившегося 
пользователя находится в переменной окружения $ІІ5ЕР, так что начнём наш сценарий со 
сбора всей необходимой информации: 



#!/изг/Ьіп/епѵ шЬу 




$ге1=пате = АК6Ѵ[0] 




$о1сігеѵ = АК6Ѵ[1] 




$пеигеѵ = АК6Ѵ[2] 




$изег = ЕІЧѴ[ 'УЗЕР! 1 ] 




риЬз "ЕігРогсіпд Роіісіез.. 


. \п(#{$гетпате}) (#{$о1сігеѵ[0, 6]}) (#{$пеигеѵ[Ѳ,6]})" 



Да, я использую глобальные переменные. Не судите строго — в таком виде получается 
нагляднее. 

Установка особого формата сообщений коммитов Первая наша задача — это заставить 
все сообщения коммитов обязательно придерживаться определённого формата. Просто чтобы 
было чем заняться, предположим, что каждое сообщение должно содержать строку вида «геі: 
1234», так как мы хотим, чтобы каждый коммит был связан с некоторым элементом в нашей 
системе с карточками. Нам необходимо просмотреть все присланные коммиты, выяснить, 
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есть ли такая строка в сообщении коммита, и, если строка отсутствует в каком-либо из этих 
коммитов, то завершить сценарий с ненулевым кодом, чтобы риз И был отклонён. 

Список значений 5НА-1 для всех присланных коммитов можно получить, взяв значения 
$пеигеѵ и $0ІсІгеѵ и передав их служебной команде діі: геѵ-1І5І:. По сути, это команда 
діі: Іод, но по умолчанию она выводит только 5НА-1 значения и больше ничего. Таким 
образом, чтобы получить список 5НА для всех коммитов, сделанных между одним 5НА коммита 
и другим, достаточно выполнить следующее: 

$ діИ геѵ-ІізГ. 538сЗЗ . . 61ЛТс7 

гі14гс7с847аЬ946ес39590гі87783с69Ь031Ьс1т'Ь7 

9т"585сІа4401Ь0а3999е84113824сІ15245с13т'0Ье 

234071а1Ье950е2а8сІ078е6141т'5ссІ20с1е61асІЗ 

СІг'а04с9ет'Зсі5197182г'13г'Ь5Ь9Ыг'Ь7717сІ2222а 

17716ес0т'11 = 1 = 5с77егТ40Ь7т'е912г'9г'6Сг'с10е475 

Можно взять этот вывод, пройти в цикле по 5НА-хешам всех этих коммитов, беря их 
сообщения и проверяя с помощью регулярного выражения, совпадает ли сообщение с шаблоном. 

Нам нужно выяснить, как из всех этих коммитов получить их сообщения, для того, чтобы 
их протестировать. Чтобы получить данные коммита в сыром виде, можно воспользоваться 
ещё одной служебной командой, которая называется діі. саі. - 1 = і1е. Мы рассмотрим все эти 
служебные команды более подробно в Главе 9, но пока что, вот, что эта команда нам выдала: 

$ діі саг.-1 = і1е соттіі са82а6 

Игее сг'сІаЗЬг"379е4г'8сІЬа8717сіее55ааЬ78аег'7г"4сІаг' 

рагепі 085ЬЬЗЬсЬ608е1е8451сІ4Ь2432г'8есЬе6306е7е7 

аиіЬог Зсоіі СИасоп <зсНасоп§дтаі1 . сот> 1205815931 -0700 

соттіііег 5соГ.1: СИасоп <зсИасоп§дтаі1 . сот> 1240030591 -0700 

сНапдей г.Не ѵегзіоп питЬег 



Простой способ получить сообщение коммита для коммита, чьё значение 5НА-1 известно, 
— это дойти в выводе команды діі: саі: - 'Гііе до первой пустой строки и взять всё, что идёт 
после неё. В Шіх-системах это можно сделать с помощью команды зесі: 

$ діі саи-тііе соттіі са82а6 | зесі , 1,/ Л $/сІ І 
сИапдесі ЬЬе ѵегзіоп питЬег 



Используйте приведённую ниже абракадабру, чтобы получить для каждого отправленного 
коммита его сообщение и выйти, если обнаружится, что что-то не соответствует требованиям. 
Если хотим отклонить отправленные данные, выходим с ненулевым кодом. Весь метод целиком 
выглядит следующим образом: 

$гедех = /\[гег": (\сі+)\]/ 
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# принуждает использовать особый формат сообщений 
сіет" спеск^іеззаде^огтат. 

тіззесІ_геѵ5 = 'діг. геѵ-іізг. #{$о1с!геѵ} . .#{$пеыгеѵ} " . зр1іг_( "\п" ) 
тіззесІ_геѵз . еасп сіо |геѵ| 

теззаде = ~діі сат.-т'Ие соттіт. #{геѵ} | зесі '1,/ Л $/о"~ 
1Т !$гедех.таг_сп(теззаде) 

рит.5 "[РОИСѴ] Ѵоиг теззаде із пот. т'огтаг.г.еа' соггесііу" 
ехіт. 1 
епсі 
епсі 
епсі 



спеск_теззаде_-Гогтаі 




Добавив это в свой сценарий ирсІа1:е, мы запретим обновления, содержащие коммиты, 
сообщения которых не соблюдают наше правило. 

Настройка системы контроля доступа для пользователей Предположим, что нам хотелось 
бы добавить какой-нибудь механизм для использования списков контроля доступа (АСЬ), где 
указано, какие пользователи могут отправлять изменения и в какие части проекта. Несколько 
людей будут иметь полный доступ, а остальные будут иметь доступ на изменение только некоторых 
подкаталогов или отдельных файлов. Чтобы обеспечить выполнение такой политики, мы запишем 
правила в файл асі, который будет находиться в нашем «голом» репозитории на сервере. Нам 
нужно будет, чтобы перехватчик ирсіа1:е брал эти правила, смотрел на то, какие файлы были 
изменены присланными коммитами, и определял, имеет ли пользователь, выполнивший риз И, 
право на обновление всех этих файлов. 

Первое, что мы сделаем, — это напишем свой АСЬ. Мы сейчас будем использовать формат 
очень похожий на механизм АСЬ в СѴ5. В нём используется последовательность строк, где 
первое поле — это аѵаііили ипаѵаіі, следующее поле — это разделённый запятыми список 
пользователей, для которых применяется правило, и последнее поле — это путь, к которому 
применяется правило (пропуск здесь означает открытый доступ). Все эти поля разделяются 
вертикальной чертой ( | ). 

В нашем примере будет несколько администраторов, сколько-то занимающихся написанием 
документации с доступом к каталогу СІОС и один разработчик, который имеет доступ только к 
каталогам ІІЬ и г.е5г.5, и наш файл асі будет выглядеть так: 

аѵаіі | піскп, ріЬуеІІ, сІе-Гипкт., іри 
аѵаіі | изіпсіаіг, ссііскепз, еЬгопг.е | гіос 
аѵаіі | зспасоп | ІіЬ 
аѵаіі | зспасоп | г.езг.5 

Начнём со считывания этих данных в какую-нибудь пригодную для использования структуру. 
В нашем случае, чтобы не усложнять пример, мы будем применять только директивы аѵаіі. 
Вот метод, который даёт нам ассоциативный массив, где ключом является имя пользователя, а 
значением — массив путей, для которых пользователь имеет доступ на запись: 
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беТ дег._ас1_ассезз_сіа1:а ( ас1_т"і1е ) 




# считывание данных АСЬ 




ас1_-Гі1е = Рііе . геасі(ас1_т"і1е) . зр1іг.( "\п" ) . ^ест. { |1іпе| Ііпе == 


" } 


ассезз = {} 




ас1_-Гі1е . еасИ сіо |1іпе| 




аѵаіі, изегз, раіп = 1іпе.зр1і(:( ' | ' ) 




пехі ипіезз аѵаіі == 'аѵаіі' 




изегз . зр1іт.( ','). еасп сіо |изег| 




ассезз[изег] | |= [] 




ассезз[изег] « рат.п 




епсі 




епсі 




ассезз 




епсі 





Для рассмотренного ранее АСЬ-файла, метод д е 1:_ас 1_асс е 5 5_сІ аі. а вернёт структуру 
данных следующего вида: 

{"аетипк1:"=>[пі1], 
"г.ри"=>[пі1], 
м піскИ"=>[пі1], 
"р]Иуе(:1:"=>[пі1], 
"зсИасоп"=>["1іЬ", "ИезИз"], 
"саіскеп5"=>["аос"], 
"изіпс1аіг"=>["сІос"] , 
"еЬгопіе"=>["аос"]} 



Теперь, когда мы разобрались с правами, нам нужно выяснить, какие пути изменяются 
присланными коммитами, чтобы можно было убедиться, что пользователь, выполнивший р и 5 И , 
имеет ко всем ним доступ. 

Мы довольно легко можем определить, какие файлы были изменены в одном коммите, с 
помощью опции - - пате - опіу для команды діі Іод (мы упоминали о ней в Главе 2): 



$ діг. Іод -1 --пате-опіу - -ргеНу^огтат. : ' 


1 91=5850 


РЕАРМЕ 




ІіЬ/Иезі.гЬ 





Если мы воспользуемся АСЬ-структурой, полученной из метода д е 1:_ас 1_ас с е 5 5_сІ аі. а, 
и сверим её со списком файлов для каждого коммита, то мы сможем определить, имеет ли 
пользователь право на отправку своих коммитов: 

# некоторые подкаталоги в проекте разрешено модифицировать только определённым пользователям 
сІе"Г спеск_а , ігес1:огу_регтз 

ассезз = де1:_ас1_ассезз_сіа1:а( ' асі 1 ) 
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# проверим, что никто не пытается прислать чего-то, что ему нельзя 
пеи_сотті1:5 = "діі геѵ-іізг. #{$о1агеѵ} . .#{$пеигеѵ} " . зр1іг_( "\п" ) 
пеи_сотті1:з . еасп сіо |геѵ| 

т'і1ез_тоа'іг"іеа' = "діг. Іод -1 --пате-опіу - -ргег.1:у=г"огта(: : 1 ' #{геѵ}~ .зр1і1:("\п") 
■Гі1ез_тосІі-ГіесІ . еасп ао |раг.п| 
пехг. 1Т раіп.зіге == Ѳ 
паз_-Гі1е_ассезз = -раізе 
ассезз [$изег] . еасп сіо | ассезз_раг.п | 

І1" ! ассезз_раіп # пользователь имеет полный доступ 

|| (раіп.іпсіех(ассе55_ра(:п) == Ѳ) # доступ к этому пути 
паз_-Гі1е_ассезз = г. те 
епсі 
епсі 

ІТ ! паз_-Гі1е_ассезз 

риг.5 "[РОИСѴ] Ѵои сіо поі паѵе ассезз іо ризп іо #{раіп}" 
ехіі: 1 
епсі 
епсі 
епсі 
епс) 

спеск_сІігес1:огу_регтз 



Большую часть этого кода должно быть не сложно понять. Мы получаем список присланных 
на сервер коммитов с помощью діі геѵ-іізі:. Затем для каждого из них мы узнаём, какие 
файлы были изменены, и убеждаемся, что пользователь, сделавший ризИ, имеет доступ ко 
всем изменённым путям. Один КиЬу'изм, который может быть непонятен это ра1:И . іпсІех(ассе55_ра1:И) 
== Ѳ. Это условие верно, если ра1:И начинается с ассе55_ра1:Н — оно гарантирует, что 
ассе55_ра1:Іі это не просто один из разрешённых путей, а что каждый путь, к которому 
запрашивается доступ, начинается с одного из разрешённых путей. 

Теперь наши пользователи не смогут отправить никаких коммитов с плохо отформатированными 
сообщениями и не смогут изменить файлы вне предназначенных для них путей. 

Разрешение только обновлений-перемоток Единственное, что нам осталось — это оставить 
доступными только обновления-перемотки. В Сіі версии 1.6 и более новых можно просто 
задать настройки гесеіѵе . сІепуОеІеІіез и гесеіѵе . сІепуМопРазІіРогиагсІз. Но осуществление 
этого с помощью перехватчика будет работать и в старых версиях Сіі, и к тому же вы сможете 
изменить его так, чтобы запрет действовал только для определённых пользователей, или ещё 
как-то, как вам захочется. 

Логика здесь такая — мы проверяем, есть ли такие коммиты, которые достижимы из 
старой версии и не достижимы из новой. Если таких нет, то сделанный риз И был перемоткой; 
в противном случае мы его запрещаем: 

# разрешаем только обновления -перемотки 
сіет" спеск_т'а51:_т"огыага' 

тіззесі_гег"5 = "діг. геѵ-іізі #{$пемгеѵ} . .#{$о1сІгеѵ} " 

тіззесІ_гег"_соііп1: = тіззесІ_ге'Г5.5р1і1:("\п") .зіге 

іт" тіззес^гет^соипг. > 0 

риіз "[РОІЛСѴ] Саппог. ризп а поп т'азг.-т'опя/ага' гет'егепсе" 
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ехіі 1 
епсі 
епсі 

сНеск^азГ^-ГогиагсІ 



Всё готово. Если вы выполните сНтосІ и+х . ді1:/гіоок5/ирсІа1:е (а это тот файл, в 
который вы должны были поместить весь наш код) и затем попытаетесь отправить ссылку, для 
которой нельзя выполнить перемотку, то вы получите что-то типа такого: 

$ діі ризН -Т огідіп тазг.ег 

СоипЫпд оЬзес1:з: 5, сіопе. 

Сотргеззіпд оЬ}'ес1:з: 100% (3/3), сіопе. 

ЫгіСіпд оЬзесИз: 100% (3/3), 323 ЬуНез, сіопе. 

Тоіаі 3 (гіеІИа 1), геизеа 1 0 (сіеііа 0) 

Ііпраскіпд оЬзесЬз: 100% (3/3), сіопе. 

ЕгтГогсіпд Роіісіез... 

(гегз/ііеасіз/тазііег) (8338с5) (с5Ь616) 

[РОИСѴ] Саппог. ризіі а погѵГазі-^опл/агсі гег"егепсе 

еггог: Иоокз/ирсіаіе ехі1:есі иііН еггог сосіе 1 

еггог: Иоок Йесііпесі іо ирсіа^е ге-Гз/Иеасіз/тазіег 

То діГ.§ді1:зегѵег : ргозесГ. . діг. 

! [гето1:е гезесіесі] таз1:ег -> тазііег (Иоок йесИпео 1 ) 
еггог: -раііесі Іо ризіі зоте гег"з іо ' ді1:§діг.5егѵег : ргозесі . діГ. ' 

Туг есть пара интересных моментов. Во-первых, когда перехватчик начинает свою работу, 
мы видим это: 



ЕгтГогсіпд Роіісіез... 
(гетз/Меайз/тазНег) (тЬ8с72) (С56860) 




Обратите внимание, что мы выводили это в йаоиГ в самом начале нашего сценария и р - 
СІа1:е. Важно отметить, что всё, что сценарий выводит в зіаоиі, будет передано клиенту. 
Следующая вещь, которую мы видим, это сообщение об ошибке: 

[РОИСѴ] Саппог. ризп а поп 1 = азг.-т'опл/ага' гет"егепсе 
еггог: поокз/ирсІа1:е ехіг.есі міг.п еггог сосіе 1 
еггог: поок Йесііпесі іо иро'аг.е ге-рз/пеао'з/тазг.ег 

Первую строку напечатали мы, а в остальных двух С-іг сообщает, что сценарий ирсіа1:е 
завершился с ненулевым кодом, и это именно то, что отклонило ваш риз И. И наконец мы 
видим это: 
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То діг.§діг.зегѵег : ргозесг. . діг. 

! [гетог.е гезесіесі] тазг.ег -> тазг.ег (поок сіесііпеа) 
еггог: гаііесі г.о ризп зоте ге-рз іо ' діг.§діг.зегѵег : ргоз'есг. . діг. ' 



Сообщение «гетоіе геіесіеа» будет появляться для каждой отклонённой перехватчиком 
ссылки. Оно сообщает нам, что ссылка была отклонена именно из-за сбоя в перехватчике. 

Кроме того, при отсутствии отметки «гег» в каком-либо из коммитов, вы увидите сообщение 
об ошибке, которое мы для этого напечатали. 

[РОИСѴ] Ѵоиг теззаде із пог. г'огтаг.г.еа' согтесііу 



Или если кто-то попытается отредактировать файл, не имея к нему доступа, то отправив 
коммит с этими изменениями, он получит похожее сообщение. Например, если человек, пишущий 
документацию, попытается отправить коммит, вносящий изменения в файлы каталога ІІЬ, то 
увидит: 

[РОИСѴ] Уои сіо пот. паѵе ассезз іо ризп г. о 1іЬ/г.езг. . гЬ 



Вот и всё. С этого момента, до тех пор пока сценарий ирсіаііе находится на своём месте и 
имеет права на исполнение, репозиторий никогда не будет откатан назад, в нём никогда не будет 
коммитов с сообщениями без вашего паттерна, и пользователи будут ограничены в доступе к 
файлам. 

7.4.2 Перехватчики на стороне клиента 

Обратная сторона такого подхода — это многочисленные жалобы, которые неизбежно 
появятся, когда отправленные пользователями коммиты будут отклонены. Когда чью-то тщательно 
оформленную работу отклоняют в последний момент, этот человек может быть сильно расстроен 
и смущён. Мало того, ему придётся отредактировать свою историю, чтобы откорректировать 
её, а это обычно не для слабонервных. 

Решение данной проблемы — предоставить пользователям какие-нибудь перехватчики, 
которые будут работать на стороне пользователя и будут сообщать ему, если он делает что-то, 
что скорее всего будет отклонено. При таком подходе, пользователи смогут исправить любые 
проблемы до создания коммита и до того, как эти проблемы станет сложно исправить. Так как 
перехватчики не пересылаются при клонировании проекта, вам придётся распространять эти 
сценарии каким-то другим способом и потом сделать так, чтобы ваши пользователи скопировали 
их в свой каталог . ді1:/Ноок5 и сделали их исполняемыми. Эти перехватчики можно поместить 
в свой проект или даже в отдельный проект, но способа установить их автоматически не существует. 

Для начала, перед записью каждого коммита нам надо проверить его сообщение, чтобы 
быть уверенным, что сервер не отклонит изменения из-за плохо отформатированного сообщения 
коммита. Чтобы сделать это, добавим перехватчик соттіі: -тзд. Если мы сможем прочитать 
сообщение из файла, переданного в качестве первого аргумента, и сравнить его с шаблоном, 
то можно заставить Сіі прервать создание коммита при обнаружении несовпадения: 
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#!/изг/Ьіп/епѵ гиЬу 

теззаде_-Гі1е = АК6Ѵ[0] 

теззаде = Рііе . геасІ(теззаде_-Гі1е) 

$гедех = /\[гег: (\сІ+)\]/ 

іт" !$гедех.тат.сп(теззаде) 

риг.з "[РОІЛСѴ] Уоиг теззаде із пот. -ГоптіаГ.г.ес1 соггест.1у" 

ехіг. 1 
епсі 



Если этот сценарий находится на своём месте (в . діІі/Иоокз/соттіІ: -тзд) и имеет 
права на исполнение, то при создании коммита с неправильно оформленным сообщением, вы 
увидите это: 

$ діт. соттіт. -ат 'іезі' 

[РОИСѴ] Ѵоиг теззаде із пот. г'огтаг.т.ео' соггесііу 



В этом случае коммит не был завершён. Однако, когда сообщение содержит правильный 
шаблон, СіГ позволяет создать коммит: 

$ діг. соттіт. -ат 'Ьезг. [геТ: 132]' 
[тазНег еѲ5с914] Иезг. [гег": 132] 
1 -рііез спапдесі, 1 іпзегт.іопз( + ) , Ѳ йе1еГ.іопз( - ) 



Далее мы хотим убедиться, что пользователь не модифицирует файлы вне своей области, 
заданной в АСЬ. Если в проекте в каталоге . діі уже есть копия файла асі, который мы 
использовали ранее, то сценарий рге - сотшіі: следующего вида применит эти ограничения: 

#!/изг/Ьіп/епѵ гиЬу 
$изег = ЕІ\ІѴ[ 'НЗЕР. 1 ] 

# [ іпзегт. ас1_ассез5_сіат.а тег.пос1 Тгот аЬоѵе ] 

# некоторые подкаталоги в проекте разрешено модифицировать только определённым пользователям 
беТ спеск_а , ігесг.огу_регтз 

ассезз = дет._ас1_ассезз_сІаг.а( ' . діт./ас1 ' ) 

■Гііез^осіі^іесі = ~ діт: сІітТ-іпсІех --саспесі --пате-опіу НЕАЭ" .зр1іт.("\п") 
^іІез^осіі-ГіесІ . еасп сіо |раг.п| 

пехг. і-Г рат.п.зі2е == Ѳ 

паз_1 = і1е_ассезз = ■раізе 

ассезз [$изег] . еасп сіо | ассезз_рат.п | 

і-Г ! ассезз_раг.п || (рат.п.іпсіех(ассе55_ра1:п) == Ѳ) 
паз_-рі1е_ассезз = т.гие 
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епй 

ІТ ! Наз_т"і1е_ассе55 

риг.5 "[РОИСѴ] Ѵои сіо поі Ііаѵе ассезз Ьо ризН Іо #{раіІі}" 
ехіГ. 1 
епсі 
епй 
епс) 

сНеск_сІігес1:огу_регтз 



Это примерно тот же сценарий, что и на стороне сервера, но с двумя важными отличиями. 
Первое — файл асі находится в другом месте, так как этот сценарий теперь запускается из 
рабочего каталога, а не из СіГ-каталога. Нужно изменить путь к АСЬ-файлу с этого: 

ассезз = дег._ас1_ассезз_сіа1:а( ' асі ' ) 



на этот: 



ассезз = дег._ас1_ассезз_с1а1:а( ' . дігѴасІ' ) 



Другое важное отличие — это способ получения списка изменённых файлов. Так как 
метод, действующий на стороне сервера, смотрит в лог коммитов, а сейчас коммит ещё не был 
записан, нам надо получить список файлов из индекса. Вместо 

^ііез^посігріесі = 'діг. Іод -1 --пате-опіу - -ргеііу^огтаг. : 1 1 #{ге1"}~ 



мы должны использовать 



т"і1ез_тосіі'Гіеа' = 'діі сіі^^-іпсіех --сасНеа 1 --пате-опіу НЕАР" 




Но это единственные два отличия — во всём остальном этот сценарий работает точно 
так же. Но надо предупредить, что он предполагает, что локально вы работаете под тем же 
пользователем, от имени которого отправляете изменения на удалённый сервер. Если это не 
так, то вам необходимо задать переменную $изег вручную. 

Последнее, что нам нужно сделать, — это проверить, что пользователь не пытается отправить 
ссылки не с перемоткой, но это случается не так часто. Чтобы получились ссылки, не являющиеся 
перемоткой, надо либо переместить ветку за уже отправленный коммит, либо попытаться отправить 
другую локальную ветку в ту же самую удалённую ветку. 

Так как сервер в любом случае сообщит вам о том, что нельзя отправлять обновления, 
не являющиеся перемоткой, а перехватчик запрещает принудительные риз И 'и, единственная 
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оплошность, которую вы можете попробовать предотвратить, это перемещение коммитов, которые 
уже были отправлены на сервер. 

Вот пример сценария рге-геЬазе, который это проверяет. Он принимает на вход список 
всех коммитов, которые вы собираетесь переписать, и проверяет, нет ли их в какой-нибудь 
из ваших удалённых веток. Если найдётся такой коммит, который достижим из одной из 
удалённых веток, сценарий прервёт выполнение перемещения: 



#!/изг/Ьіп/епѵ гиЬу 




Ьазе_ЬгапсН = АК6Ѵ[0] 




Іг АК6Ѵ[1] 




Иоріс_ЬгапсИ = АРСѴ[1] 




еізе 




1:оріс_ЬгапсН = "НЕАО" 




епсі 




Г.агде(:_зНаз = ~ді1: геѵ-ІізГ. #{Ьазе_ЬгапсН} . .#{Г.оріс_ 


_ЬгапсИ}~ .зр1і1:("\п") 


гетоіе_ге-Гз = ~діі ЬгапсИ -г' . зр1і(:( "\п" ) .тар { |г| 


Г.БІГІр } 


Г.агде(:_зНаз . еасН сіо |зИа| 




гето(:е_гет"5 . еасИ сіо | гето1:е_гет' | 




зИаз_ризИесі = "діі геѵ-іізі: Л #{зІіа} Л § ге'Гз/гето1:ез/#{гето(:е_ге'Г} ' 


ІТ зИаз_ризИесІ.зр1і1:("\п") .Іпс1исіе?(з1іа) 




риіз "[РОИСѴ] Соттіі: #{зИа} Иаз аігеасіу Ьееп 


ризИесі іо #{гето1:е_ге-Г}" 


ехіГ. 1 




епсі 




епсі 




епсі 





Этот сценарий использует синтаксис, который мы не рассматривали в разделе «Выбор 
ревизии» в Главе 6. Мы получили список коммитов, которые уже были отправлены на сервер, 
выполнив это: 



діі геѵ-ІізГ. Л #{зИа} Л § гег"з/гето(:ез/#{гето1:е_ге-г'} 




Запись 5НА~@ означает всех родителей указанного коммита. Мы ищем какой-нибудь 
коммит, который достижим из последнего коммита в удалённой ветке и не достижим ни из 
одного из родителей какого-либо 5НА, который вы пытаетесь отправить на сервер — это значит, 
что это перемотка. 

Главный недостаток такого подхода — это то, что проверка может быть очень медленной и 
зачастую избыточной — если вы не пытаетесь отправить данные принудительно с помощью - 
г", сервер и так выдаст предупреждение и не примет данные. Однако, это интересное упражнение 
и теоретически может помочь вам избежать перемещения, к которому потом придётся вернуться, 
чтобы исправить. 
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7.5 Итоги 

Мы рассмотрели большинство основных способов настройки клиента и сервера СіІ'а с 
тем, чтобы он был максимально удобен для ваших проектов и при вашей организации рабочего 
процесса. Мы узнали о всевозможных настройках, атрибутах файлов и о перехватчиках событий, 
а также рассмотрели пример настройки сервера с соблюдением политики. Теперь вам должно 
быть по плечу заставить Сіі подстроиться под практически любой тип рабочего процесса, 
который можно вообразить. 
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Наш мир несовершенен. Как правило, вы не сможете моментально перевести любой 
проект, в котором вы участвуете, на использование СіГ. Иногда вам придется иметь дело с 
проектами, использующими другую систему контроля версий, и, в большинстве случаев, этой 
системой будет ЗиЪѵегзіоп. Первая часть этого раздела научит вас обращаться с діі 5ѴП — 
встроенным в СК двухсторонним интерфейсом обмена с ЗиЪѵегеіоп. 

В какой-то момент, вы, возможно, захотите перевести свой существующий проект на 
Сіі. Вторая часть раздела расскажет о том, как провести миграцию: сначала с ЗиЬѵегзіоп, 
потом с Регіогсе, и наконец, с помощью написания собственного сценария для нестандартных 
вариантов миграции. 



8.1 Сіі и 8иЬѵег5Іоп 

В настоящее время большинство проектов с открытым исходным кодом, а также большое 
число корпоративных проектов, используют ЗиЪѵегеіоп для управления своим исходным кодом. 
Это самая популярная на текущий момент система управления версиями с открытым исходным 
кодом, история её использования насчитывает около 10 лет. Кроме того, она очень похожа на 
СѴ5, систему, которая была самой популярной до ЗиЬѵегвіоп. 

Одна из замечательных особенностей Ск — возможность двустороннего обмена с 5иЬ- 
ѵегвіоп через интерфейс, называемый діі зѵп. Этот инструмент позволяет вам использовать 
СіІ в качестве корректного клиента при работе с сервером ЗиЪѵегзіоп. Таким образом, вы 
можете пользоваться всеми локальными возможностями Сіі, а затем сохранять изменения на 
сервере ЗиЬѵегвіоп так, как если бы использовали ЗиЬѵегеіоп локально. То есть вы можете 
делать локальное ветвление и слияние, использовать индекс, перемещение и отбор патчей для 
переноса из одной ветви в другую (спеггу-ріскіп§) и т.д., в то время, как ваши коллеги будут 
продолжать использовать в разработке подход времён каменного века. Это хороший способ 
протащить СіГ в рабочее окружение своей компании, чтобы помочь коллегам разработчикам 
стать более эффективными, в то время как вы будете лоббировать переход полностью на Сіі. 
Интерфейс обмена с ЗиЬѵегвіоп это ворота в мир распределённых систем управления версиями. 
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8.1.1 §ІІ 8ѴП 

Базовой командой в СіГ для всех команд работающих с мостом к ЗиЪѵегзіоп является діі 
5ѴП. Ей предваряется любая команда. Она принимает довольно порядочное число команд, 
поэтому мы изучим из них, те которые наиболее часто используются, рассмотрев несколько 
небольших вариантов работы. 

Важно отметить, что при использовании діі: зѵп, вы взаимодействуете с ЗиЬѵегвіоп 
— системой, которая намного менее «продвинута», чем Сіі. Хоть вы и умеете с лёгкостью 
делать локальное ветвление и слияние, как правило лучше всего держать свою историю в 
как можно более линейном виде, используя перемещения (геЬазе) и избегая таких вещей, как 
одновременный обмен с удалённым репозиторием СіС 

Не переписывайте свою историю, попробуйте отправить изменения ещё раз, а также не 
отправляйте изменения в параллельный СН-репозиторий, используемый для совместной работы, 
одновременно с другими разработчиками, использующими Сіі. ЗиЬѵегзіоп может иметь только 
одну единственную линейную историю изменений, сбить с толку которую очень и очень просто. 
Если вы работаете в команде, в которой некоторые разработчики используют СіГ, а другие 
ЗиЬѵегвіоп, убедитесь, что для совместной работы все используют только ЗѴІЧ-сервер — это 
сильно упростит вам жизнь. 

8.1.2 Настройка 

Для того, чтобы попробовать этот функционал в действии, вам понадобится доступ с 
правами на запись к обычному 5 ѴМ-репозиторию. Если вы хотите повторить рассматриваемые 
примеры, вам нужно сделать доступную на запись копию моего тестового репозитория. Это 
можно сделать без труда с помощью утилиты зѵпзупс, входящей в состав последних версий 
ЗиЬѵегзіоп (по крайней мере после версии 1.4). Для этих примеров, я создал новый ЗиЬѵегзіоп- 
репозиторий на Соо§1е Сосіе, который был частичной копией проекта ргоІіоЬиІ 1 (утилита 
шифрования структурированных данных для их передачи по сети). 

Чтобы мы могли продолжить, прежде всего создайте новый локальный репозиторий 5иЬ- 
ѵегзіоп: 

$ тксііг /Шр/1:ез1:-зѵп 

$ зѵпасітіп сгеаіе /Іітр/ІіезЬ-зѵп 



Затем разрешите всем пользователям изменять геѵргорз — самым простым способом 
сделать это будет добавление сценария рге-геѵргор-сИапде, который просто всегда завершается 
с кодом 0: 

$ саі /ітр/1:ез1:-зѵп/Ііоок5/рге-геѵргор-сНапде 

#!/Ьіп/зИ 

ехіі 0; 

$ сНтосІ +х /1:тр/1:ез1:-зѵп/Иоокз/рге-геѵргор-сИапде 

Теперь вы можете синхронизировать проект со своей локальной машиной, вызвав зѵп - 
зупс іпіі: с параметрами задающими исходный и целевой репозиторий: 
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$ зѵпзупс іпіі 1"і1е:///1:тр/(;ез1:-5ѵп Н«р://ргоді1:-ехатр1е.доод1есосіе.сот/5ѵп/ 



Эта команда подготовит процесс синхронизации. Затем склонируйте код выполнив: 

$ зѵпзупс зупс гі1е:///1:тр/іез1-зѵп 

Соттіііесі геѵізіоп 1. 

СоріесІ ргорегПез Тог геѵізіоп 1. 

Соттіііесі геѵізіоп 2. 

Соріесі ргорегПез -Тог геѵізіоп 2. 

Соттіііесі геѵізіоп 3. 



Хотя выполнение этой операции и может занять всего несколько минут, однако, если 
вы попробуете скопировать исходный репозиторий в другой удалённый репозиторий, а не в 
локальный, то процесс займёт почти час, хотя в этом проекте менее ста коммитов. ЗиЬѵегзіоп 
вынужден клонировать ревизии по одной, а затем отправлять их в другой репозиторий — это 
чудовищно неэффективно, однако это единственный простой способ выполнить это действие. 

8.1.3 Приступим к работе 

Теперь, когда в вашем распоряжении имеется ЗѴІЧ-репозиторий, для которого вы имеете 
право на запись, давайте выполним типичные действия по работе с СУВ. Начнём с команды 
діі; 5ѴП сіопе, которая импортирует весь 5ѴМ-репозиторий в локальный Сіг-репозиторий. 
Помните, что если вы производите импорт из настоящего удалённого ЗѴІЧ-репозитория, вам 
надо заменить Тііе : ///ішр/іезі - зѵп на реальный адрес вашего ЗѴІЧ-репозитория: 

$ діі зѵп сіопе гі1е:///1:тр/(:е5(:-5ѵп -Т ігипк -Ь ЬгапсНез -і іадз 

Іпіііаіігесі ешрііу Сіі герозііогу іп /ІІзегз/зсІіасоп/ргозес1:з/(:ез1:зѵпзупс/зѵп/ . діі/ 

П = Ь4е387Ьс68740Ь5аГ56с2а5ГаГ4003ае42ЬсІ135с (ігипк) 

А ш4/асх_р(:Іігеасі . тЛ 

А ш4/з1:1_ІіазІі.т4 

г75 = сИ957-гЗЬ307922124еес6314е15Ьссіа59еЗсі9610 (Игипк) 
Роипсі роззіЫе ЬгапсИ роіп!:: ^ііе : ///1:тр/1:ез1:-зѵп/І:гипк => \ 

■рі1е:///1:тр/1:ез(:-зѵп /ЬгапсИез/ту-саІс-ЬгапсИ, 75 
РоипсІ ЬгапсИ рагепС: (ту-саІс-ЬгапсИ) сЛ957г'ЗЬЗѲ7922124еес6314е15Ьссіа59еЗсІ961Ѳ 
Роііоміпд рагепі міііі гіо_змі1:сІі 
Зиссезз-Гиііу ^оііоыесі рагепі: 

г76 = 8624824ессѲЬасІсІ73т'4Ѳеа2г'01г'се51894189ЬѲ1 (ту-саіс - ЬгапсИ ) 
СИескесІ оиИ НЕАй : 
•рііе : ///Шр/Ііезіі-зѵп/ЬгапсНез/ту-саІс-ЬгапсГі г76 



Эта команда эквивалентна выполнению для указанного вами ІШЬ двух команд — діі 
5ѴП іпіг., а затем діі зѵп Те^сЬ. Процесс может занять некоторое время. Тестовый 
проект имеет всего лишь около 75 коммитов, и кода там не очень много, так что скорее всего, 
вам придётся подождать всего несколько минут. Однако, СіІ должен по отдельности проверить 
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и выполнить коммит для каждой версии. Для проектов, имеющих историю с сотнями и тысячами 
изменений, этот процесс может занять несколько часов или даже дней. 

Часть команды -Т 1:гипк -Ь ЬгапсИез і. ад 5 сообщает С-іг, что этот 5ѴТЧ- 
репозиторий следует стандартным соглашениям о ветвлении и метках. Если вы используете 
не стандартные имена: Гшпк, ЬгапсЬев и іа§з, а какие-то другие, то должны изменить эти 
параметры соответствующим образом. В связи с тем, что такие соглашения являются общепринятыми, 
вы можете использовать короткий формат, заменив всю эту часть на -5, заменяющую собой 
все эти параметры. Следующая команда эквивалента предыдущей: 



$ діі зѵп сіопе гі1е:///1:тр/1:е5І:-зѵп -з 




Таким образом, вы должны были получить корректный СіІ-репозиторий с импортированными 
ветками и метками: 



$ діЬ Ьгапсіі -а 






* тазіег 






ту-са1с-ЬгапсИ 






Иадз/2.0.2 






1:адз/ге1еазе-2 


.0, 


,1 


1:адз/ге1еазе-2 


.0, 


.2 


1:адз/ге1еазе-2 


.0, 


2ГСІ 


Іігипк 







Важно отметить, что эта утилита именует ваши ссылки на удалённые ресурсы по-другому. 
Когда вы клонируете обычный репозиторий С-іІ, вы получаете все ветки с удалённого сервера 
на локальном компьютере в виде: огідіп/[ЬгапсИ] — в пространстве имён с именем 
удалённого сервера. Однако, діі 5ѴП полагает, что у вас не будет множества удалённых 
источников данных и сохраняет все ссылки на всякое, находящееся на удалённом сервере, без 
пространства имён. Для просмотра всех имён ссылок вы можете использовать служебную 
команду С-ігзНои-геІ": 



$ діі зпом-гет" 










1сЬсі49Ѳ4сі99821 = 386СІ871 = 88-Гсе1с24асІ7с0-Г0471 


ге1=з/1іеасіз/піаз1:ег 








аее1есс26318164Г355а8831 = 5сІ99сГГ0с852сІЗс4 


ге1=з/гето1:ез/ту-са1с-Ьгапс 


:Ь 






03сі09Ь0е2аасІ427е34а6СІ50-Г 1=14712867600601=5 


ге1=з/гето1:ез/1:адз/2 .0.2 








50сІ02сс0асіс9аа4319ееЬа0900430Ьа219Ь9с376 


ге1=з/гето1:ез/1:адз/ге1еазе- 


■2. 


■ Ѳ. 


Л 


4сааа711а50с77879а91Ь8Ь90380060г"672745сЬ 


ге-Гз/гето1:ез/1:адз/ге1еазе- 


■2. 


0. 


2 


1с4сЬ508144с5131=1=1214с3488аЬе66СІсЬ929161= 


ге-Гз/гето1:ез/1:адз/ге1еазе- 


•2. 


,0. 


2гс1 


1сЬсі4904с199821=386СІ87г'88т'се1с24асІ7сѲт'0471 


ге1=з/гето1:ез/1:гипк 









Обычный С-К-репозиторий выглядит скорее так: 



$ діі зпом-ге1= 

83е38с7а0а1=325а97221=21=сіс56Ы0188806сі83а1 геГз/Иеайз/тазНег 
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Зе15е38с198Ьаас84223ас1 = с6224ЬЬ8Ь991 = 1 ; 2281 ге-рз/гетоГез/дИзегуег/тазГег 
ѲаЗѲс]сІЗЬѲс795Ь8Ѳ212ае72364Ѳсі4е5сІ48саЬсіг'г' ге^з/гетоііез/огідіп/тазііег 
258123803871 = сісі55-г916652Ье4881с6г'116Ѳ0сі6т геГз/гетоИез/огідіп/ИезИіпд 



Здесь два удалённых сервера: один с именем дііізегѵег и веткой тазііег, и другой с 
именем огідіп с двумя ветками: тазііег и іезііпд. 

Обратите внимание, что в примере, где ссылки импортированы из діі 5ѴП, метки добавлены 
так, как будто они являются ветками, а не так, как настоящие метки в СіГ. Импортированные из 
ЗиЬѵегвіоп данные выглядят так, как будто под именами меток с удалённого ресурса скрываются 
ветки. 

8.1.4 Коммит в 8иЬѵег§іоп 

Теперь, когда у вас есть рабочий репозиторий, вы можете выполнить какую-либо работу с 
кодом и выполнить коммит в апстрим, эффективно используя СіГ в качестве клиента 5 ѴІЧ. Если 
вы редактировали один из файлов и закоммитили его, то вы внесли изменение в локальный 
репозиторий Сіг, которое пока не существует на сервере ЗиЬѵегвіоп: 

$ діі соттіі: -ат 'Асісііпд діі-зѵп іпз1:гис1:іопз іо 1:Ие КЕАРМЕ ' 
[тазЬег 97Ѳ31е5] Асісііпд ді1:-зѵп іпз1:гис1:іопз іо іЬе КЕАОМЕ 
1 ■рііез сИапдесІ, 1 іпзег1:іопз( + ) , 1 сіе1е1:іопз( - ) 



После этого, вам надо отправить изменения в апстрим. Обратите внимание, как СіГ изменяет 
способ работы с ЗиЬѵегвіоп — вы можете сделать несколько коммитов оффлайн, а затем отправить 
их разом на сервер ЗиЬѵегвіоп. Для передачи изменений на сервер ЗиЬѵегвіоп требуется выполнить 
команду діі. зѵп сісоштіі:: 

$ діі зѵп сісоттіі: 

Сотті(:(:іпд 1 = і1е:///1:тр/(:е5І:-5ѵп/1:гипк ... 

М РЕАРМЕ.СхИ 
Соттіііесі г79 

М РЕАРМЕ.СхИ 
Г79 = 938Ыа547с2сс92033Ь74сІ32Ѳ30е86468294а5с8 (Игипк) 
N0 сИапдез ЬеШееп сиггепі: НЕАй апсі ге^Гз/гетоЬез/Іігипк 
Кезеіііпд 1:о ІЬе Іаіезі: ге-Гз/гето(:ез/1:гипк 



Это действие возьмёт все коммиты, сделанные поверх того, что есть в ЗѴІЧ-репозитории, 
выполнит коммит в ЗиЬѵегвіоп для каждого из них, а затем перепишет ваш локальный коммит 
в Сіі, чтобы добавить к нему уникальный идентификатор. Это важно, поскольку это означает, 
что изменятся все 5НА-1 контрольные суммы ваших коммитов. В частности и поэтому работать 
с одним и тем же проектом одновременно и через СіС, и через ЗиЪѵегеіоп это плохая идея. 
Взглянув на последний коммит, вы увидите, что добавился новый діі - зѵп - ісі: 
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$ діі Іод -1 

соттіі 938Ыа547с2сс92ѲЗЗЬ74сі32030е86468294а5с8 

АиІНог: зсНасоп <зспасоп@4с93Ь258-373т-11с1е-Ье05-5т7а86268029> 

Оаіе: 5аі Мау 2 22:06:44 2009 +0000 

Аааіпд діі-зѵп іпз1:гис1:іопз іо Ігіе КЕАРМЕ 



діГ-зѵп-ісІ: гі1е:///1:тр/1:е5І:-5ѵп/1:гипк@79 4с93Ь258-373г-11сіе-Ье05-5-Г7а86268029 




Обратите внимание — контрольная сумма 5НА, которая начиналась с 97031е5 когда 
вы делали коммит, теперь начинается с 938Ыа5. Если вы хотите отправить изменения как 
на Сіі-сервер, так и на ЗѴІЧ-сервер, вы должны отправить их (сісоттіі:) сначала на сервер 
ЗиЬѵегвіоп, поскольку это действие изменит отправляемые данные. 

8.1.5 Получение новых изменений 

Если вы работаете вместе с другими разработчиками, значит когда-нибудь вам придётся 
столкнуться с ситуацией, когда кто-то из вас отправит изменения на сервер, а другой, в свою 
очередь, будет пытаться отправить свои изменения, конфликтующие с первыми. Это изменение 
не будет принято до тех пор, пока вы не сольёте себе чужую работу. В діі зѵп эта ситуация 
выглядит следующим образом: 

$ діі зѵп сісоттіі: 

Соттііііпд 1:о г"і1е:///1:тр/1:е5І:-5ѵп/1:гипк ... 

Мегде соггРІісІ: сіигіпд соттіі:: Ѵоиг ■рііе ог сіігесііогу ' КЕАРМЕ . 1x1: ' із ргоЬаЫу \ 
ои1:-от"-с)а1:е : гезоигсе оиі: оТ сіаіе; Ггу ирсіаііпд аХ /ІІзегз/зспасоп/1іЬехес/ді1:-\ 
соге/діі-зѵп Ііпе 482 



Для разрешения этой проблемы, вам нужно выполнить команду діі зѵп геЬазе, 
которая получит все изменения, имеющиеся на сервере, которых ещё нет на вашей локальной 
машине и переместит все ваши недавние изменения поверх того, что было на сервере: 

$ діі зѵп геЬазе 

М РЕА0МЕ.СХ1: 
г80 = гг829аЬ914е8775с7с025с1741ЬеЬЗсІ523ее30Ьс4 (Игипк) 
Рігзі, геміпсііпд МеасІ Ьо геріау уоиг могк оп іор о1" И... 
Арріуіпд: -ГІГЗІ: изег сИапде 



Теперь все ваши изменения находятся сверху того, что есть на ЗѴІЧ-сервере, так что вы 
можете спокойно выполнить сісоштіі:: 

$ діі зѵп сісоттіі: 

СоттіИііпд Ьо ті1е:///Г.тр/Ье5І-5ѵп/Г.гипк ... 

М РЕАРМЕ.СхИ 
Соттіііесі г81 
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М КЕАОМЕ.СхИ 
г81 = 456сЬе6337аЬе49154аЬ701Ѳ6сІ1836Ьс1332сІеесІ (Игипк) 
N0 сИапдез ЬеШееп сиггепі: НЕАй апсі ге^з/гетоііез/іігипк 
Кезеііііпд 1:о 1:Ие Іаіезі: ге-рз/гетоіез/іігипк 



Следует помнить, что в отличие от С-іГ'а, который требует сливать себе изменения в апстриме, 
которых у вас ещё нет локально, перед тем как отправить свои изменения, діі: 5ѴП заставляет 
делать такое только в случае конфликта правок. Если кто-либо внесёт изменения в один файл, 
а вы внесёте изменения в другой, команда сісоттіі: сработает без ошибок: 

$ діі зѵп сісоттіі: 

Сотті(:(:іпд 1:о -Гі1е:///1:тр/1:ез1:-зѵп/1:гипк ... 

М соігГідиге . ас 

СоттіііесІ г84 

М аиЬодеп.зН 
г83 = 8аа54а74а'452г'82еее1ѲѲ76аЬ2584сГгс424853Ь (Игипк) 

М соігГідиге . ас 

г84 = саЬас939211ссЫ8аа744е581е46563аг'5а , 962а , Ѳ (Игипк) 

И: а , 2г'23Ь8Ѳт"67аааа1г'6т'5аает"48г'се3263ас7:і.а92 апб гетз/гетоИез/Сгипк сІігТег, \ 
изіпд геЬазе: 

:1ѲѲ755 1ѲѲ755 ега5а59965тЪЬЬ5Ь2Ь0а1289Ѳт1Ь351ЬЬ5493с18 \ 
015е4с98с482г'0г'а71е4а , 5434338Ѳ1453ѲЬ37т'а6 М аиНодеп.зИ 
Рігзі, геміпсііпд ИеасІ 1:о геріау уоиг могк оп іор оТ 11... 



Это важно помнить, поскольку последствием этих действий может стать такое состояние 
проекта, которого нет ни на одном из ваших компьютеров. Если изменения несовместимы, 
но не ведут к конфликту изменений у вас могут возникнуть проблемы, которые трудно будет 
диагностировать. Это отличается от работы с СіІ-сервером — в СіІ вы можете полностью 
проверить состояние проекта на клиентских машинах до публикации, в то время, как в 5ѴМ вы 
не можете даже быть уверены в том, что состояние проекта непосредственно перед коммитом 
и после него идентично. 

Кроме того, вам нужно выполнить следующую команду для получения изменений с сервера 
ЗиЬѵегвіоп, даже если вы не готовы сами сделать коммит. Вы можете выполнить діі зѵп 
геіісгі для получения новых данных, нодіі: зѵп геЬазе и извлечёт новые данные с 
сервера, и обновит ваши локальные коммиты. 

$ діі зѵп геЬазе 

М депегаіе_сіезсгір1:ог_рго1:о . зИ 

Г82 = ЬсІ16сЛ ; 9173е424с6-Г52с337аЬ6еГа7-Г76432821 = 1 (Игипк) 
Рігзі, геміпсііпд Меасі Ьо геріау уоиг могк оп іор оТ И... 
Раві-Тогѵіагбеб тазіег 1:о ге'Гз/гетоЬез/Ггипк . 



Выполняйте команду д і 1: зѵп геЬазе периодически, чтобы быть уверенным в том, что 
ваш код имеет самую свежую версию. Перед выполнением этой команды убедитесь, что ваш 
рабочий каталог чист. Если нет, вы должны либо «спрятать» свои изменения, либо временно 
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закоммитить их перед выполнением діі зѵп геЬазе, иначе выполнение этой команды 
прекратится, если она обнаружит возникновение конфликта слияния. 

8.1.6 Проблемы с ветвлением в Сіі 

После того как вы привыкли к работе с Сіі, вы наверняка будете создавать ветки для 
работы над отдельными задачами, а затем сливать их. Если вы отправляете изменения на 
сервер ЗиЬѵегвіоп через діі: зѵп, вам скорее всего потребуется перемещать свою работу 
каждый раз в одну ветку, а не сливать ветки вместе. Причина, по которой предпочтение должно 
быть отдано именно такому подходу, заключается в том, что ЗиЪѵегеіоп имеет линейную историю 
изменений и не может обрабатывать слияния так, как это делает Сіі. Таким образом діі 5ѴП 
проходит только по первым родителям при конвертации снимков состояния в коммиты 5иЬ- 
ѵегкіоп. 

Допустим, что история изменений выглядит следующим образом: вы создали ветку ех- 
регішепі:, сделали два коммита, а затем слили их в ветку шазііег. Если вы выполните 
СІсоштіІ:, результат будет следующим: 

$ діі зѵп сісоттіі: 

Сотті(:(:іпд ті1е:///1:тр/1:ез1:-зѵп/1:гипк ... 

М СНАМбЕЗ.ИхИ 
СоттіііесІ г85 

М СНАМбЕЗ.ИхИ 
г85 = 4ЬгеЬеес434сІ156с36т'2ЬссІ18г"4еЗсі97ас3269а2 (Игипк) 
N0 сНапдез ЬеШееп сиггепі: НЕАО апсі ге^Гз/гетоІіез/Іігипк 
КезеШпд Го 1:Ме Іаіезі: гег"з/гето<:ез/1:гипк 
СОРПМС.ИхИ: Іосаііу тосіітіесі 
ІМЗТАЬЬЛхЬ: Іосаііу тосіітіесі 

М СОРПМС.ИхИ 

м тмзтаи-.ихи 
Соттіііесі г86 

М ІМЗТАИ.ИХІ: 

м сорпме.ихи 
г86 = 2647т6Ь86сс1 = саасІ4ес58с52Ѳе369ес81^7с283с (Игипк) 
N0 сИапдез Ьеімееп сиггепі: НЕАй апсі ге^з/гетоіез/іігипк 
Кезеіііпд 1:о ІЬе Іаіезі: ге-Гз/гетоіез/Іігипк 




Выполнение сісоттіі: для ветки с объединённой историей не вызовет никаких проблем. 
Однако, если вы посмотрите на историю проекта в Сіі, то увидите, что ни один из коммитов, 
которые вы сделали в ветке ехрегішепііне были переписаны — вместо этого, все эти изменения 
появятся в 5ѴМ версии как один объединённый коммит. 

Когда кто-нибудь склонирует себе эту работу, всё, что он увидит — это коммит, в котором 
все изменения слиты воедино; он не увидит данных о том, откуда они взялись и когда они были 
внесены. 

8.1.7 Ветвление в 8иЬѵег§іоп 

Работа с ветвями в ЗиЬѵегвіоп отличается от таковой в СИ; если у вас есть возможность 
избегать её, то это наверное лучший вариант. Хотя, вы можете создавать и вносить изменения 
в ветки ЗиЬѵегвіоп используя діі: зѵп. 



226 



Зсоіі СЬасоп Рго Сіі 



Раздел 8.1 Оіі и ЗиЬѵегзіоп 



Создание новой ветки в Для того, чтобы создать новую ветку в ЗиЪѵегеіоп, выполните 

діі: 5ѵп ЬгапсН [имя ветки]: 

$ діі зѵп ЬгапсИ орега 

Соруіпд -Гі1е:///1:тр/1:е5І:-5ѵп/1:гипк аі. г87 Ьо -Гі1е:///1:тр/1:ез(:-зѵп/ЬгапсИез/орега. . . 
РоипсІ роззіЫе Ьгапсіі роіп!:: -Гі1е:///1:тр/1:ез1:-5ѵп/1:гипІ< => \ 

^ііе : ///1:тр/1:ез1:-5ѵп/ЬгапсМез/орега, 87 
Роипсі ЬгапсИ рагепі: (орега) 11 = 6Ы = е471083сЬса06ас8сі4176Г7асІ4сІеѲсі62е5Г 
Роііоиіпд рагепі иііИ с!о_зиі1:сИ 
Зиссезз'ГиНу 'Гоііомесі рагепС 

Г89 = 9Ь6геѲЬ9Ѳс5с9аа , г'9165т7ѲѲ897518а , Ьс54а7сЬг' (орега) 



Эта команда эквивалентна команде ЗиЬѵегкіоп 5 ѵп сору 1:гипк ЬгапсНез/орега и 
выполняется на сервере ЗиЪѵегзіоп. Важно отметить, что эта команда не переключает вас на 
указанную ветку Так что, если вы сейчас сделаете коммит, он попадёт на сервере в 1:гипк, а 
не в орега. 

8.1.8 Переключение активных веток 

СіГ определяет ветку, куда вносятся ваши коммиты, путём выбора самой последней ЗиЬѵегвіоп- 
ветки в вашей истории — она должна быть единственной и она должна быть последней в 
текущей истории веток, имеющей метку діі. - зѵп - ісі. 

Если вы хотите работать одновременно с несколькими ветками, вы можете настроить 
локальные ветки на внесение изменений через сісоштіі: в конкретные ветки ЗиЪѵегеіоп, начиная 
их на основе импортированного ЗѴІЧ-коммита для нужной ветки. Если вам нужна ветка орега, 
в которой вы можете поработать отдельно, можете выполнить: 



$ діі ЬгапсИ орега гетоГез/орега 




Теперь, если вы захотите слить ветку орега в 1:гипк (вашу ветку тазііег), вы можете 
сделать это с помощью обычной команды діі. шегде. Однако вам потребуется добавить 
подробное описание к коммиту (через параметр -т), иначе при слиянии комментарий будет 
иметь вид «Мег§е ЬгапсЬ орега», вместо чего-нибудь полезного. 

Помните, что хотя вы и используете діі шегде для этой операции, и слияние скорее 
всего произойдёт намного проще, чем было бы в ЗиЬѵегзіоп (потому, что СіГ автоматически 
определяет подходящую основу для слияния), это не является обычным коммитом-слиянием 
Сіі. Вы должны передать данные обратно на сервер ЗиЬѵегзіоп, который не способен справиться 
с коммитом, имеющим более одного родителю, так что после передачи этот коммит будет 
выглядеть как один коммит, в который затолканы все изменения с другой ветки. После того, как 
вы сольёте одну ветку в другую, вы не сможете просто так вернуться к работе над ней, как вы 
могли бы в Сіг. Команда сісотшіі: удаляет всю информацию о том, какая ветка была влита, так 
что последующие вычисления базы слияния будут неверными — команда сісоштіі: сделает 
результаты выполнения діі шегде такими же, какими они были бы после выполнения діі 
шегде --здиазИ. К сожалению, избежать подобной ситуации вряд ли удастся — ЗиЬѵег- 
5Іоп не способен сохранять подобную информацию, так что вы всегда будете связаны этими 
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ограничениями. Во избежание проблем вы должны удалить локальную ветку (в нашем случае 
орега) после того, как вы вольёте её в 1:гипк. 

8.1.9 Команды 8иЬѵег§іоп 

Набор утилит діі: 5 ѵп предоставляет в ваше распоряжение несколько команд для облегчения 
перехода на Сіі, путём предоставления функциональности, подобной той, которую вы имеете 
в ЗиЬѵегвіоп. Ниже приведены несколько команд, которые дают вам то, что вы имели в 5иЬ- 
ѵегвіоп. 



Просмотр истории в стиле Если вы привыкли к ЗиЬѵегвіоп и хотите просматривать 

историю в стиле выполните команду діі зѵп Іод, чтобы увидеть историю коммитов 
в формате таком же как в 5Ѵ1Ч: 



$ дИ зѵп Іод 


Г87 | ЗсИасоп | 2009-05-02 
аиЬодеп сНапде 


16: 


:07: 


:37 


-0700 


(За*, 


02 Мау 2009) 


1 2 


Ііпез 


г86 | зсНасоп | 2009-05-02 
Мегде ЬгапсИ ' ехрегітепі: ' 


16: 


:00; 


:21 


-0700 


(5аС, 


02 Мау 2009) 


1 2 


Ііпез 


г85 | зсііасоп | 2009-05-02 
ирсіаіесі 1:Ие сИапдеІод 


16 


:00 


:09 


-0700 


(ЗаЬ, 


02 Мау 2009) 


1 2 


Ііпез 



Вы должны знать две важные вещи о команде діі: зѵп Іод. Во-первых, она работает в 
оффлайне, в отличие от оригинальной команды 5ѴП Іод, которая запрашивает информацию 
с сервера ЗиЬѵегвіоп. Во-вторых, эта команда отображает только те коммиты, которые были 
переданы на сервер ЗиЬѵегвіоп. Локальные коммиты СіГ, которые вы ещё не отправили с 
помощью сісотшіі: не будут отображаться, равно как и коммиты, отправленные на сервер 
ЗиЬѵегвіоп другими людьми с момента последнего выполнения сісотшіі:. Результат действия 
этой команды скорее похож на последнее известное состояние изменений на сервере ЗиЬѵег- 

5ІОП. 

8Ѵ1Ѵ-Аннотации Так же как команда діі: зѵп Іод симулирует в оффлайне команду зѵп 
Іод, эквивалентом команды з ѵп ап п о іаіе является команда діі зѵп Ыате [ФАЙЛ]. 
Её вывод выглядит следующим образом: 

$ діі зѵп Ыате РЕАйМЕ.ІіхІ: 
2 іетрогаі Ргоіосоі Ви'Г'Гегз - Соод1е'з аа*а іп1:егсИапде ■Гогта* 
2 іетрогаі СоругідЫ; 2008 боодіе Іпс. 

2 іетрогаі Ыір : //соде . доодіе . сот/аріз/ргоіосоІЬи-Г-Гегз/ 
2 іетрогаі 
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22 


іетрогаі С++ Іпзіа11а1:іоп - ІІпіх 


22 


іетрогаі 


2 


іетрогаі 


79 


зсНасоп СоттіІ:1:іпд іп ді!:-зѵп. 


78 


зсНасоп 


2 


(іетрогаі То Ьиіісі апсі іпзіаіі 1:Ие С++ Ргоіосоі Ви'Г'Гег гип1:іте апсі ІІіе Рго1:осо1 


2 


іетрогаі Ви'Г'Гег сотрііег (ргоіос) ехесиіе (:1іе 'Роііоыіпд : 


2 


іетрогаі 



Опять же, эта команда не показывает коммиты, которые вы сделали локально в СіІ или те, 
которые за то время были отправлены на ЗиЬѵегвіоп-сервер. 

Информация о ЗѴІЧ-сервере Вы можете получить ту же информацию, которую даёт выполнение 
команды 5 ѵп і пт" о, выполнив команду діг. зѵп іітГо: 

$ діі зѵп ігтГо 
РаІН: . 

ІІКІ. : Иіірз : //зсНасоп-ІезІ: . доодіесосіе . сот/зѵп/ігипк 

Керозііогу Рооі:: Иі(:рз://зсИасоп-(:ез1:.доод1есосІе.сопі/зѵп 

Верозііогу иию: 4с93Ь258-3731=-11с1е-Ье05-51 = 7а86268029 

Кеѵізіоп: 87 

ІЧосІе Кіпсі : сіігесіогу 

ЗсИесІиІе: погтаі 

І_азі СИапдесі АиІіМог: зсИасоп 

І-азі СИапдесі Кеѵ: 87 

І_азі СІіапдесІ Эаіе: 2009-05-02 16:07:37 -07Ѳ0 (За!:, 02 Мау 2009) 




Так же, как Ыате и Іод, эта команда выполняется оффлайн и выводит информацию, 
актуальную на момент последнего вашего обращения к серверу ЗиЪѵегкіоп. 

Игнорирование того, что игнорирует 8иЬѵег§іоп Если вы клонируете репозиторий ЗиЬѵег- 
5іоп, в котором где-то установлены свойства зѵп : ідпоге, скорее всего вы захотите создать 
соответствующие им файлы . діг.ідпоге, чтобы ненароком не добавить в коммит те файлы, 
которые не стоит добавлять. Для решения этой проблемы в діг. зѵп имеется две команды. 
Первая — діг. зѵп сгеаг.е-ідпоге — автоматически создаст соответствующие файлы 
. дИідпоге, и затем вы можете добавить их в свой следующий коммит. 

Вторая команда — діг. зѵп зНои-ідпоге, которая выводит на стандартный вывод 
строки, которые вы должны включить в файл . діг.ідпоге. Таким образом вы можете перенаправить 
вывод этой команды в файл исключений вашего проекта: 

$ діі зѵп зНои-ідпоге > . діЬ/ігтГо/ехсІисіе 



Поступая таким образом, вы не захламляете проект файлами .діг.ідпоге. Это правильный 
подход, если вы являетесь единственным пользователем СіІ в команде, использующей ЗиЬѵег- 
5іоп, и ваши коллеги выступают против наличия файлов . дііідпоге в проекте. 
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8.1.10 Заключение по Си-8ѵп 

Утилиты діі 5ѴП полезны в том случае, если ваша разработка по каким-то причинам 
требует наличия рабочего сервера ЗиЬѵегвіоп. Однако, вам стоит смотреть на СіГ использующий 
мост в ЗиЬѵегвіоп как на урезанную версию Сіі. В противном случае вы столкнётесь с проблемами 
в преобразованиях, которые могут сбить с толку вас и ваших коллег. Чтобы избежать неприятностей, 
старайтесь следовать следующим рекомендациям: 

• Держите историю в СіГ линейной, чтобы она не содержала коммитов-слияний, сделанных 
спомощью діі: тегде. Перемещайте всю работу, которую вы выполняете вне основной 
ветки обратно в неё; не выполняйте слияний. 

• Не устанавливайте отдельный СК-сервер для совместной работы. Можно иметь один 
такой сервер для того, чтобы ускорить клонирование для новых разработчиков, но не 
отправляйте на него ничего, не имеющего записи діі: - зѵп - ісі. Возможно, стоит даже 
добавить перехватчик рге - гесеіѵе, который будет проверять каждый коммит на наличие 
діі: - 5ѴП - ісі и отклонять діі. ризИ, если коммиты не имеют такой записи. 

При следовании этим правилам, работа с сервером ЗиЬѵегвіоп может быть более-менее 
сносной. Однако, если возможен перенос проекта на реальный сервер Сіг, преимущества от 
этого перехода дадут вашему проекту намного больше. 

8.2 Миграция на Сіі 

Если вы решили начать использовать СіГ, а у вас уже есть база исходного кода в другой 
СУВ, вам придётся как-то мигрировать свой проект. Этот раздел описывает некоторые из 
инструментов для импортирования проектов, включённых в состав СіГ для самых распространённых 
систем, в конце описывается создание вашего собственного инструмента для импортирования. 

8.2.1 Импортирование 

Вы научитесь импортировать данные из двух самых популярных систем контроля версий 
— ЗиЬѵегвіоп и Регпэгсе — поскольку они охватывают большинство пользователей, которые 
переходят на Сіі, а также потому, что для обеих систем созданы высококлассные инструменты, 
которые поставляются в составе Сіі. 

8.2.2 8иЬѵег§іоп 

Если прочли предыдущий раздел об использовании діі 5ѴП, вы можете с лёгкостью 
использовать все инструкции, имеющиеся там для клонирования репозитория через діі: зѵп 
сіопе. Затем можете отказаться от использования сервера ЗиЬѵегзіоп и отправлять изменения 
на новый СН-сервер, и использовать уже его. Вытащить историю изменений, можно так же 
быстро, как получить данные с сервера ЗиЬѵегвіоп (что, однако, может занять какое-то время). 

Однако, импортирование не будет безупречным. И так как оно занимает много времени, 
стоит сделать его правильно. Первая проблема это информация об авторах. В ЗиЪѵегеіоп 
каждый коммитер имеет свою учётную запись в системе, и его имя пользователя отображается 
в информации о коммите. В примерах из предыдущего раздела выводилось 5 с И асо п в некоторых 
местах, например, в выводе команд Ыате и діі. зѵп Іод. Если вы хотите преобразовать эту 
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информацию для лучшего соответствия данным об авторах в Сіі, вам потребуется отобразить 
пользователей ЗиЪѵегзіоп в авторов в Сіі. Создайте файл и 5 е г 5 . іхі, в котором будут содержаться 
данные об этом отображении в таком формате: 

зсНасоп = ЗсоЫ: СИасоп <зсНасоп§деетаі1 . сот> 
зеізе = Зотео №1зе <зе1зе@деетаі1 . сот> 

Для того, чтобы получить список авторов, который использует вы можете выполнить 
следующее: 

$ зѵп Іод --хті | дгер аи!:Ііог | зогі: -и | регі -ре 'з/.>( .?)<./$! = /' 



Это даст вам на выходе журнал в формате ХМХ — в нём вы можете просмотреть информацию 
об авторах, создать из неё список с уникальными записями и избавиться от ХМХ разметки. 
(Конечно, эта команда сработает только на машине с установленными дгер, зогХ, и регі). 
Затем перенаправьте вывод этого скрипта в свой файл ивеге.Ш, чтобы потом можно было 
добавить к каждой записи данные о соответствующих пользователях из Сіі. 

Вы можете передать этот файл как параметр команде діі 5 ѴП, для более точного преобразования 
данных об авторах. Кроме того, можно дать указание діі 5ѴП не включать метаданные, 
обычно импортируемые ЗиЬѵегвіоп, передав параметр - -П0-те1:асІа1:а команде сіопе или 
ІПІг.. Таким образом, команда для импортирования будет выглядеть так: 

$ діі-зѵп сіопе ИІ(:р://ту-рго]ес(:.доод1есосІе.сот/зѵп/ \ 

- -аи1:Иогз-1 = і1е=изегз . іхі - -по-те1:асіа1:а -з ту_ргозес1: 



Теперь в вашем каталоге ту_р г о ~] есі: будут находиться более приятно выглядящие данные 
после импортирования. Вместо коммитов, которые выглядят так: 

соттіі 37е-Га680е8473Ь615сіе98Ѳ1 = а935944215428а35а 

АіЯНог: зсИасоп <зсІіасоп@4с93Ь258-373-Г-11с)е-Ье05-51 ; 7а86268029> 

ОаНе: 5ип Мау 3 00:12:22 2009 +0000 

■ріхесі Іпз1:а11 - до 1:о 1:гипк 



ді1:-зѵп-ісі : ІтСЬрз : //ту-рго]есі . доодіесосіе . сот/зѵп/1:гипк§94 4с93Ь258-373-г-11а'е- 
Ье05-5-Г7а86268029 




они будут выглядеть так: 



соттіі 03а8785Г44с8еа5ссіЬ0е8834Ь7с8е6с469Ье21 = 1 ; 2 
АиІіИог: Зсоіі СМасоп <зсИасоп§деетаі1 . сот> 
ОаНе: 5ип Мау 3 00:12:22 2009 +0000 
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Теперь не только поле АиіЬог выглядит намного лучше, но и строке ді1:-5ѴП-ісІ больше 

нет. 

Вам потребуется сделать небольшую «уборку» после импорта. Сначала вам нужно убрать 
странные ссылки, оставленные діі. 5ѴП. Сначала мы переставим все метки так, чтобы они 
были реальными метками, а не странными удалёнными ветками. А затем мы переместим 
остальные ветки так, чтобы они стали локальными. 

Для приведения меток к корректному виду меток Сіг выполните: 



$ ср -К-р . діі/ге-Гз/гетоІіез/Ііадз/* . ді1:/гет"5/1:адз/ 
$ гт -К-р . ді1:/ге-Г5/гето1:ез/1:адз 




Эти действия переместят ссылки, которые были удалёнными ветками, начинающимися с 
1:ад/ и сделают их настоящими (легковесными) метками. 

Затем, переместите остальные ссылки в ге^з/гетоііез так, чтобы они стали локальными 
ветками: 

$ ср -К-р . діг/ге-рз/гетоііез/* . діІі/ге-гз/НеасІз/ 
$ гт -Кг' . дИ/гег'з/гетоГез 



Теперь все старые ветки стали реальными СіГ-ветками, а все старые метки — реальными 
метками Сіі. Последнее, что осталось сделать, это добавить свой СіГ-сервер в качестве удалённого 
ресурса и отправить на него данные. Вот пример добавления сервера как удалённого источника: 



$ діі гето^е асісі огідіп ді1:іту-ді(:-зегѵег:тугерозі1:огу.ді1: 




Так как вы хотите, чтобы все ваши ветви и метки были переданы на этот сервер, выполните: 
$ діі ризИ огідіп --аіі 



Теперь все ваши ветки и метки должны быть импортированы на новый СіГ-сервер в чистом 
и опрятном виде. 

8.2.3 Регіогсе 

Следующей системой, для которой мы рассмотрим процедуру импортирования, будет Рег- 
гогсе. Утилита импортирования для Регюгсе также входит в состав Сіі, но только в секции 
сопіігіЬ исходного кода — она не доступна по умолчанию, как діі зѵп. Для того, чтобы 
запустить её, вам потребуется получить исходный код СіІ, располагающийся на §іІ.кегпе1.ог§: 
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$ діі сіопе діі : //діі . кегпеі . огд/риЬ/зст/дИ/дИ . діг. 
$ ссі діі/сопІігіЬ/Газі-ітрогІ: 



В каталоге г"аз1:-ітрог1: вы найдёте исполняемый скрипт Руіпоп, с названием діі- 
р4. Вы должны иметь на вашем компьютере установленный Рушоп и утилиту р4 для того, 
чтобы эта утилита смогла работать. Допустим, например, что вы импортируете проект т ат 
из Реггогсе РиЫіс Бероі:. Для настройки вашей клиентской машины, вы должны установить 
переменную окружения Р4РОКТ, указывающую на депо Регіогсе: 

$ ехрогі Р4Р0РЛ"=риЫіс. реггогсе. сот: 1666 

Запустите команду діі: - р4 сіопе для импортирования проекта ]ат с сервера Регіогсе, 
передав в качестве параметров депо и путь к проекту, а также путь к месту, куда вы хотите 
импортировать проект: 

$ діг.-р4 сіопе //риЫіс/заш/згс§а11 /ор1:/р4ітрог1: 
Ітрогііпд 1гот //риЫіс/зат/згс§а11 іп1:о /ор1:/р4ітрог1: 
Кеіпіііаіігесі ехізііпд бИ герозііогу іп /ор1:/р4ітрог1:/ . діі/ 
Ітрогі сіез^іпаііоп: ге-Гз/гето!:ез/р4/таз1:ег 
Ітрогііпд геѵізіоп 4409 (100%) 



Если вы теперь перейдёте в каталог /ор1:/р4ітрог 1: и выполните команду діі Іод, 
вы увидите импортированную информацию: 

$ діі Іод -2 

соттіі 1та4ес126171790ета2а , Ь83548Ь85Ь1ЬЬЬс07а , с2 
АиІіИог: Реггогсе зіагТ оиррогІіірег-Гогсе . сот> 
Оаіе: ТИи Аид 19 10:18:45 2004 -0800 

Огор 'гсЗ' топікег о-Г }'ат-2.5. Роісіесі гс2 апсі гсЗ ВЕІ.М0ТЕ5 іп1:о 
іііе таіп рагі о-Г іИе сіоситепі. Вил.11: пем іаг/гір Ьаііз. 

Опіу 16 топіИз Іаіег. 

[ді(:-р4: сІероІ-раіИз = "//риЫіс/зат/згс/" : сИапде = 4409] 

соттіі са8870а , Ь541а23еа867г'38847есІа65Ьг'4363371сІ 
АиЬИог: КісИагсі беідег <гтд§реі"гогсе . сот> 
Оаіе: Тие Арг 22 20:51:34 2003 -0800 

ІІрсІа1:е сіегіѵесі затдгат.с 

[ді(:-р4: сІероІ-раіИз = "//риЫіс/зат/згс/" : сИапде = 3108] 



Как видите, в каждом коммите есть идентификатор діі: - р4. Оставить этот идентификатор 
будет хорошим решением, если позже вам понадобится узнать номер изменения в Регіогсе. 
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Однако, если вы всё же хотите удалить этот идентификатор — теперь самое время это сделать, 
до того, как вы начнёте работать в новом репозитории. Можно воспользоваться командой діі: 
^ІИег - ЬгапсИ для одновременного удаления всех строк с идентификатором: 

$ діі ГіИіег-ЬгапсІі - -тзд-т"і11:ег 1 
зеа -е "/ Л \[ді1:-р4:/а" 

I 

РѲИГІСе 1т'а4ес126171790е1 = а , 2а , Ь83548Ь85Ь1ЬЬЬс07сІс2 (123/123) 
КеГ ' геГз/Неасіз/тазіег ' иаз геигШеп 

Если вы теперь выполните діі: Іод, то увидите, что все контрольные суммы 5НА-1 
изменились, и что строки содержащие діі - р4 больше не появляются в сообщениях коммитов: 

$ діі Іод -2 

соттіі 10а16а'60сгТса14а454а15с6164378т'4082Ьс5Ь0 
АиІіМог: Регтогсе зіатТ <зиррог1:§рег1 ; огсе . сот> 
Оаіе: ТИи Аид 19 10:18:45 2004 -0800 

Эгор 'гсЗ' топікег о-Г }ат-2.5. Роісіесі гс2 апсі гсЗ ВЕІ.М0ТЕ5 іп1:о 
іпе таіп рагі о-Г іИе сіоситепі. Вил.11: пем іаг/гір Ьаііз. 

Опіу 16 топіИз Іаіег. 

соттіі 2Ь6с6сІЬ311сІсІ76с34с66ес1с40а49405е6Ь527Ь2 
АиЬИог: КісИагсІ беідег <гтд@регт"огсе . сот> 
Оаіе: Тие Арг 22 20:51:34 2003 -0800 



Урсіаііе сіегіѵесі ^атд^ат.с 




Ваш импортируемый репозиторий готов к отправке на новый СП-сервер. 

8.2.4 Собственная утилита для импорта 

Если вы используете систему отличную от ЗиЬѵегвіоп или Регюгсе, вы можете поискать 
утилиту для импорта под свою систему в интернете — для СѴ5, Сіеаг Саве, Ѵівиаі Зоигсе 
Зайэ и даже для простого каталога с архивами уже существуют качественные инструменты 
для импортирования. Если ни один из этих инструментов не подходит для ваших целей, либо 
если вам нужен больший контроль над процессом импортирования, вам стоит использовать 
утилиту діі ^азі -ішрогі. Эта команда читает простые инструкции со стандартного входа, 
управляющие процессом записи специфичных данных в Сіі. Намного проще создать необходимые 
объекты в СіІ используя такой подход, чем запуская базовые команды Сіі, либо пытаясь записать 
сырые объекты (см. главу 9). При использовании діі ^азі - ішрог вы можете создать 
сценарий для импортирования, который считывает всю необходимую информацию из импортируемой 
системы и выводит прямые инструкции на стандартный вывод. Затем вы просто запускаете 
этот скрипт и используя конвейер (ріре) передаёте результаты его работы на вход діі {'аз! - 
ітрогЪ. 

Чтобы быстро продемонстрировать суть этого подхода, напишем простую утилиту для 
импорта. Положим, что вы работаете в каталоге сиггепі.и время от времени делаете резервную 
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копию этого каталога добавляя к имени дату — Ьас к_УУУУ_ММ_00, и вы хотите импортировать 
это всё в Сіі. Допустим, ваше дерево каталогов выглядит таким образом: 

$ 1з /ор1/ітрог1_1тот 

Ьаск_2009_Ѳ1_02 

Ьаск_2009_Ѳ1_Ѳ4 

Ьаск_2ѲѲ9_Ѳ1_14 

Ьаск_2009_Ѳ2_ѲЗ 

сиггепі: 




Для того, чтобы импортировать всё это в Сіі, надо вспомнить, как С-іІ хранит данные. 
Как вы помните, С-іі в своей основе представляет собой связный список объектов коммитов, 
указывающих на снимки состояния их содержимого. Всё, что вам требуется, это сообщить 
команде г"азг. -Ітрогг. что является данными снимков состояния, какие данные коммитов 
указывают на них и порядок их следования. Стратегией наших действий будет обход всех 
снимков состояния по очереди и создание соответствующих коммитов с содержимым каждого 
каталога, с привязкой каждого коммита к предыдущему. 

Так же как и в главе 7 в разделе «Пример создания политики в С-іІ», мы напишем сценарий 
на КлЪу, поскольку это то, с чем я обычно работаю, и кроме того он легко читается. Но вы 
можете создать его на любом другом языке, которым владеете — он просто должен выводить 
необходимую информацию на стандартный вывод. Если вы работаете под \Ѵіпсіо\ѵ5, то должны 
особым образом позаботиться о том, чтобы в конце строк не содержались символы возврата 
каретки — діі г"аз1: - ітрог 1: принимает только символ перевода строки (ЬР), а не символ 
перевода строки и возврата каретки (СК1Р), который используется в \Ѵіпс1о\ѵ5. 

Для того, чтобы начать, вы должны перейти в целевой каталог и идентифицировать каждый 
подкаталог, являющийся снимком состояния, который вы хотите импортировать в виде коммита. 
Основной цикл будет выглядеть следующим образом: 

1аз1:_тагк = піі 

# Іоор ІИгоидИ ІИе сіігесііогіез 

ОІГ.СІ1СІІГ(АРІ6Ѵ[0] ) сіо 

0іг.д1оЬ("*") .еасИ сіо |сііг| 
пехі: і-р Рі1е.-Гі1е?(сііг) 

# тоѵе іггЕо 1:гіе іагдеі: сіігесііогу 
Оіг.сМіг(сііг) сіо 

1аз1:_тагк = ргіп1:_ехрог1:(сІіг, 1аз1:_тагк) 
епсі 
епсі 
епсі 

Вы запускаете функцию ргіп1:_ехрог 1: внутри каждого каталога, она берёт запись и 
отметку предыдущего снимка состояния и возвращает запись и отметку текущего; таким образом 
они соединяются нужным образом между собой. «Отметка» — это термин утилиты г"а5І:- 
Ішро Г і., обозначающий идентификатор, который вы даёте коммиту; когда вы создаёте коммиты, 
вы назначаете каждому из них отметку, которую можно использовать для связывания с другими 
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коммитами. Таким образом, первая операция, которую надо включить в метод р г іп 1:_ехро г 
это генерация отметки из имени каталога: 

тагк = сопѵегІ:_аіг_(:о_тагк(аіг) 



Мы сделаем это путём создания массива каталогов и используя значение порядкового 
номера каталога в массиве, как его отметку, поскольку отметка должна быть целым числом: 

$шагкз = [] 

беТ сопѵег1:_сІіг_1:о_тагк(сііг) 
ІТ !$тагкз.іпс1исіе?(сііг) 

$тагкз « сііг 
епсі 

($тагкз.іпсіех(сііг) + 1).1:о_з 
епсі 



Теперь, когда мы имеем целочисленное представление нашего коммита, нам нужны даты, 
чтобы указывать их в метаданных коммитов. Поскольку дата записана в имени каталога, мы 
выделяем её оттуда. Следующей строкой в сценарии ргіп1:_ехрог 1: будет: 

ааГе = сопѵег1:_сІіг_(:о_с1а1:е(сІіг) 



где метод сопѵег1:_сІіг_1:о_сІа1:е определён как: 

сіег" сопѵег1:_сІіг_1:о_сІа1:е(с1іг) 
ІТ сііг == 'сиггепі' 

геіигп Тіте . пои( ) . 1:о_і 
еізе 

сііг = сііг . дзиЬ( ' Ьаск_' , '') 
(уеаг, топ1:М, сіау) = аіг . зр1і(:( '_' ) 
геіигп Тіте . 1оса1(уеаг, топЬп, сіау ) . 1:о_і 
епсі 
епсі 



Этот метод возвращает целочисленное значение даты для каждого каталога. Последняя 
часть метаданных, которая нам нужна для всех коммитов это данные о коммитере, которые мы 
жёстко задаём в глобальной переменной: 

$аиГИог = 'ЗсоЫ Спасоп <зсИасоп§ехатр1е . сот> ' 

Теперь мы готовы приступить к выводу данных коммита в своём сценарии импорта. Дадим 
начальную информацию говорящую, что мы задаём объект коммита, ветку, на которой он 
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находится, затем отметку, которую мы ранее сгенерировали, информацию о коммитере и сообщение 
коммита, а затем предыдущий коммит, если он есть. Код выглядит следующим образом: 

# ргіпі: 1:гіе ітрогі: іпГогта1:іоп 
риііз 'соттіі: геГз/ПеасІз/тазІіег ' 
риСз ' тагк : ' + тагк 

риНз "соттіИИег #{$аиіИог} #{сІа1:е} -Ѳ700" 
ехрогі_сіа1:а( ' ітрогіесі Тгот ' + сііг) 
ри!:з '■Ггот :' + 1азі_тагк І1" 1аз(:_тагк 



Мы жёстко задаём часовой пояс (-0700), поскольку так проще. Если вы импортируете 
данные из другой системы, вы должны указать часовой пояс в виде смещения. Сообщение 
коммита должно быть представлено в особом формате: 

сіаііа (зіге)\п(соп1:еп(:з) 



Формат состоит из слова сіа1:а, размера данных, которые требуется прочесть, символа 
переноса строки и, наконец, самих данных. Поскольку нам потребуется использовать такой 
же формат позже, для описания содержимого файла, создадим вспомогательный метод ех- 
рог1:_сІа1:а: 



деТ ехрог1:_сІа1:а(з1:гіпд) 

ргіпі "сіа1:а #{зігіпд . зіге}\п#{з(:гіпд}" 
епсі 




Всё что нам осталось, это описать содержимое файла для каждого снимка состояния. 
Это просто, поскольку каждый из них содержится в каталоге: мы можем вывести команду 
сіеіеііеаіі, за которой следует содержимое каждого файла в каталоге. После этого С-іг соответствующим 
образом позаботится о регистрации каждого снимка: 

риіз 1 Йе1е1:еа11 ' 
0іг.д1оЬ("**/*") .еасИ сіо | Гііе | 

пехі гг !Рі1е.-гі1е?(ті1е) 

Іп1іпе_сіа1:а ( 'Гііе ) 
епсі 



Примечание: поскольку многие системы рассматривают свои ревизии как изменения от 
одного коммита до другого, г"а5г. - ітрог 1; также может принимать команды задающие для 
каждого коммита, какие файлы были добавлены, удалены или модифицированы, а также что 
является новым содержимым файлов. В нашем примере вы могли бы вычислить разность 
между снимками состояния и предоставить только эти данные, но это сложнее. С таким же 
успехом можно предоставить СіІ все данные для того, чтобы он сам вычислил разницу. Если 
с вашими данными проще предоставлять разницу между снимками состояния, обратитесь к 
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странице руководства ^азі-ітрогі: для получения подробностей о том как предоставлять 
данные таким способом. 

Формат для задания содержимого нового файла, либо указания нового содержимого изменённого 
файла следующий: 

М 644 іпііпе раІЬ/іо/ТИе 
даіа (зіге) 
(т"і1е соп1:еп1:з) 



Здесь, 644 — это права доступа (если в проекте есть исполняемые файлы, вам надо выявить 
их и назначить им права доступа 755), а параметр ІПІІпе говорит о том, что содержимое будет 
выводиться непосредственно после этой строки. Метод Іп1іпе_с1а1:а выглядит следующим 
образом: 

веТ Іп1іпе_сіа1:а(т"і1е, сойе = 'М 1 , тосіе = '644') 

сопіепі: = Рііе . геасі(1 = і1е) 

риНз "#{сосіе} #{тосІе} іпііпе #{гі1е}" 

ехрогі_сіа1:а(соп1:еп(:) 
епсі 



Мы повторно используем метод ехрог1:_сІа1:а, определённый ранее, поскольку он работает 
тут так же, как и при задании сообщений коммитов. 

Последнее, что вам осталось сделать, это вернуть текущую отметку, чтобы её можно было 
передать для использования в следующую итерацию: 

ге1:игп тагк 

ПРИМЕЧАНИЕ: Если вы работаете под ѴѴіпаошв, то должны убедиться, что добавили ещё 
один дополнительный шаг. Мы уже упоминали, что \Ѵіпсіо\ѵ5 использует СКЕР для перехода на 
новую строку, тогда как діі. Таві. -ітрогі; ожидает только ЕР. Для того, чтобы избежать этой 
проблемы и сделать процесс импорта безошибочным, вам нужно сказать КлЪу использовать 
ЕР вместо СКЕР: 

$з1:сІои(: . Ьіптосіе 



Это всё. Если вы теперь запустите этот сценарий, то получите примерно следующее 
содержимое: 

$ гиЬу ітрогГ.гЬ /орі/ітрог1:_ттот 
соттіі ге-гз/НеасІ5/таз1:ег 
тагк : 1 

соттіЬСег ЗсоИИ СМасоп <зсНасоп§деетаі1 . сот> 123Ѳ883200 -Ѳ700 
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сіаИа 29 

ішрогіесі -Ггош Ьаск_2Ѳ09_01_02сіе1е1:еа11 
М 644 іпііпе 'ГіІе.гЬ 
сіаіа 12 
ѵегзіоп і.ѵіо 

соттіі ге-Гз/ИеасІз/таз1:ег 
тагк :2 

соттіііег ЗсоЫ: СМасоп <зсИасоп§деетаі1 . сот> 1231056000 -0700 
сіаіа 29 

ітрогіесі тгот Ьаск_2009_01_04г'гот :1 
сіе1е1:еа11 

М 644 іпііпе 'ГіІе.гЬ 

сіаіа 14 

ѵегзіоп 1:Игее 

М 644 іпііпе пеи.гЬ 

сіаіа 16 

пей ѵегзіоп опе 
(...) 



Для того, чтобы запустить утилиту импорта, перенаправьте этот вывод на вход д 'Газі;- 
ішрогі:, находясь в каталоге Сіг, в который хотите совершить импортирование. Вы можете 
создать новый каталог, а затем выполнить в нём діі ІПІ1: и потом запустить свой сценарий: 



$ діі іпИ 

Іпіііаіігесі ешріу Оіі герозіііогу іп /орі/ітрогЦо/.діі/ 

$ гиЬу ітрогЬ.гЬ /орІ/ітрог^Ргот | діі: газі-ітрогі: 
діІ-^ГазІі-ітрогІ: зіаіізііісз : 



АНос'с! оЬзесГз: 


5000 








То1:а1 оЬзес1:з 




18 


( 


1 сіиріісаіез 


) 


ЫоЬз 




7 


( 


1 сіиріісаіез 


0 сІеІИаз) 


ігеез 




6 


( 


0 сіиріісаіез 


1 сІеИаз) 


соттіііз 




5 


( 


0 сіиріісаіез 


0 сІеІИаз) 


іадз 




0 


( 


0 сіиріісаіез 


0 сІеІИаз) 


ТоЬа! Ьгапспез: 


1 


( 


1 Іоасіз ) 




тагкз : 




1024 


( 


5 ипідие ) 




аіотз : 




3 








Метогу Іоіаі: 




2255 


КІВ 






рооіз : 




2098 


КІВ 






оЬзесІіз : 




156 


КІВ 







раск_герог1: : деірадезіге( ) = 4096 

раск_герог1: : соге . раскесібіШіпсіоія/Зіге = 33554432 

раск_герог1: : соге . раскес16і1:І-іті1: = 268435456 

раск_герог1: : раск_изесі_с1:г = 9 

раск_герог1: : раск_ттар_са11з = 5 

раск_герогІ: : раск_ореп_міпсІои5 = 1 / 1 

раск_герог1: : раск_таррес! = 1356 / 1356 



Как видите, после успешного завершения, СіІ выдаёт большое количество информации о 
проделанной работе. В нашем случае мы на итог импортировали 18 объектов для 5 коммитов 
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в одну ветку. Теперь выполните діі Іод, чтобы увидеть свою новую историю изменений: 
$ діг. Іод -2 

соттіі 10Ьте7а , 22се15ее25Ь60а824с8982157са593а , 41 
Аи1:пог: ЗсоЫ: Спасоп <зспасоп§ехатр1е . сот> 
Оаіе: 5ип Мау 3 12:57:39 2ѲѲ9 -0700 

ітрогііесі тУот сиггепі: 

соттіі 7е519590СІе754сІ079а , а , 73Ь44сІ695а42с9а , 2а , г"452 
АиІіИог: ЗсоЫ: СМасоп <зсНасоп§ехатр1е . сот> 
Оаіе: Тие РеЬ 3 01:00:00 2009 -0700 

ітрогИесі тгот Ьаск_2009_02_03 



Ну вот, вы получили чистый и красивый С-К-репозиторий. Важно отметить, что пока у вас 
нет никаких файлов в рабочем каталоге — вы должны сбросить свою ветку на ветку тазііег: 

$ І5 

$ діі гезеі: --ИагсІ тазііег 

НЕАй із пом аі. 1ѲЪ?е7б ітрогіесі гтот сиггепС 
$ 1з 

гіІе.гЬ ІіЬ 



С помощью утилиты ^азі-ітрогі; можно делать намного больше — манипулировать 
разными правами доступа, двоичными данными, несколькими ветками, совершать слияния, 
назначать метки, отображать индикаторы прогресса и многое другое. Некоторое количество 
примеров более сложных сценариев содержится в каталоге сопІігіЬ/^азІі-ітрогІ: исходного 
кода Сіі; один из самых лучших из них — сценарий діі. - р4, о котором я уже рассказывал. 

8.3 Итоги 

После всего вышесказанного, вы должны чувствовать себя уверенно при совместной работе 
с С-іГ и ЗиЬѵегзіоп и при выполнении импортирования практически любого существующего 
репозитория в репозиторий С-іГ без потерь данных. Следующая глава раскроет перед вами 
внутреннюю механику Сіі, так что вы будете способны создать каждый необходимый байт 
данных, если потребуется. 
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Вы могли прочитать почти всю книгу перед тем, как приступить к этой главе, а могли 
только часть. Так или иначе, в данной главе рассматриваются внутренние процессы СіГ и 
особенности его реализации. На мой взгляд, изучение этих вещей это основа понимания того, 
насколько СіІ полезный и мощный инструмент. Хотя некоторые утверждают, что изложение 
этого материал может сбить новичков с толку и оказаться для них неоправданно сложным. 
Именно поэтому эта глава отнесена в конец, давая возможность заинтересованным освоить её 
раньше, а сомневающимся — позже. 

Итак, приступим. Во-первых, напомню, что СіГ это по сути контентно-адресуемая файловая 
система с пользовательским СУВ-интерфейсом поверх неё. Довольно скоро станет понятнее, 
что это значит. 

На заре развития Сіі (примерно до версии 1.5), интерфейс был значительно сложнее, 
поскольку был более похож на интерфейс доступа к файловой системе, чем на законченную 
СУВ. За последние годы, интерфейс значительно улучшился и по удобству не уступает аналогам; 
у некоторых, тем не менее, с тех пор сохранился стереотип о том, что интерфейс у Сіг чересчур 
сложный и труден для изучения. 

Контентно-адресуемая файловая система — основа СіГ, очень интересна, именно её мы 
сначала рассмотрим в этой главе; далее будут рассмотрены транспортные механизмы и инструменты 
обслуживания репозитория, с которыми вам в своё время возможно придётся столкнуться. 

9.1 Сантехника и фарфор 

В этой книге было описано как пользоваться СіГ используя примерно три десятка команд, 
например, сНескоиІ:, ЬгапсН, гетоііеит.п. Но так как сначала Ск был скорее инструментарием 
для создания СУВ, чем СУВ удобной для пользователей, в нём полно команд, выполняющих 
низкоуровневые операции, которые спроектированы так, чтобы их можно было использовать в 
цепочку в стиле ІШІХ, а также использовать в сценариях. Эти команды как правило называют 
служебными («р1шпЪіп§» — трубопровод), а более ориентированные на пользователя называют 
пользовательскими («рогсеіаіп» — фарфор). 

Первые восемь глав книги были посвящены практически только пользовательским командам. 
В данной главе же рассматриваются именно низкоуровневые служебные команды, дающие 
контроль над внутренними процессами СіІ и показывающие, как он работает и почему он 
работает так, а не иначе. Предполагается, что данные команды не будут использоваться напрямую 
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из командной строки, а будут служить в качестве строительных блоков для новых команд и 
пользовательских сценариев. 

Когда вы выполняете діі: іпіі: в новом или существовавшем ранее каталоге, Сіі создаёт 
подкаталог . дІЪ, в котором располагается почти всё, чем он заправляет. Если требуется 
выполнить резервное копирование или клонирование репозитория, достаточно скопировать 
всего лишь один этот каталог, чтобы получить почти всё необходимое. И данная глава почти 
полностью посвящена его содержимому. Вот так он выглядит: 

$ 15 
НЕ АР 

ЬгапсМез/ 

соітГід 

сіезсгірііоп 

Ноокз/ 

іпсіех 

ігтГо/ 

оЬ]есіз/ 

гег"з/ 

Там могут быть и другие файлы, но непосредственно после діі: іпіі вы увидите именно 
это. Каталог ЬгапсИезне используется новыми версиями Сіг, а файл сіезсгіріііоп требуется 
только программе СіІ\ѴеЬ, на них не стоит обращать особого внимания. Файл СОГТРІд содержит 
настройки проекта, а каталог ІітРо — файл с глобальным фильтром, игнорирующим те файлы, 
которые вы не хотите поместить в .§ій§поге. В каталоге Иоокз располагаются клиентские и 
серверные хуки, подробно рассмотренные в главе 7. 

Итак, осталось четыре важных элемента: файлы НЕАЭ, іпсіех и каталоги оЬзесІіз, 
гег'з. Это ключевые элементы хранилища Сіг. В каталоге оЬзесІіз находится, собственно, 
база данных, в Г е'Гз — ссылки на объекты коммитов в этой базе (ветки). Файл НЕАО указывает 
на текущую ветку, и в файле іпсіех хранится информация индекса. В последующих разделах 
данные элементы будут рассмотрены более подробно. 

9.2 Объекты в Сіі 

Сіт — контентно-адресуемая файловая система. Здорово. Но что это означает? А означает 
это, что в своей основе СіГ — простое хранилище ключ-значение. Можно добавить туда любое 
содержимое, в ответ будет выдан ключ, по которому это содержимое можно извлечь. Для 
примера, можно воспользоваться служебной командой ИазИ-оЬзесІ:, которая добавляет данные 
в каталог . діі: и возвращает ключ. Для начала создадим новый СіІ-репозиторий и убедимся, 
что каталог оЪ] ее 1:5 пуст: 

$ тксііг іезі: 
$ ссі Ьезі: 
$ діі іпі1: 

Іпі1:іа1ігесі етріу Сіі герозііогу іп /ітр/іезі/ .діі/ 
$ -ГіпсІ . дііѴоЬзесЬз 
. дИ/оЬ^ес^з 
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. діг./оІ^ес1:з/іпт"о 

. ді!:/оЬзес1:з/раск 

$ -ГіпсІ . діі:/оЬіесІ:5 -іуре г" 

$ 

Сіі проинициализировал каталог оЪ] ее 1:5 и создал в нём подкаталоги раек и іп 'Го, пока 
без файлов. Теперь добавим кое-какое текстовое содержимое в базу СіІ'а: 

$ есИо Чезі: сопг.епг.' | діт: МазН- окрест, -и --зісііп 
сШ70460Ь4Ь4аесе5915са-г5с68сЛ2г560а9геЗе4 



Ключ -и команды Назгі - оЬ есі: указывает, что объект необходимо сохранить, иначе 
команда просто выведет ключ и всё. Флаг - - 5ІІСІІП указывает, что данные необходимо считать 
со стандартного ввода, в противном случае НазН-оЬзесІ: ожидает имя файла. Вывод команды — 
40-символьная контрольная сумма. Это хеш 5НА-1 — контрольная сумма содержимого и 
заголовка, который будет рассмотрен позднее. Теперь можно увидеть, в каком виде будут 
сохранены ваши данные: 



$ -ГіпсІ . дііѴоЬіесіз -іуре Т 

.діІ/оЬзес1:з/сі6/7Ѳ460Ь4Ь4аесе5915са1 ; 5с68сЛ21 = 560а91 = еЗе4 




В каталоге оЬзесІіз появился файл. Это и есть начальное внутреннее представление 
данных в СіІ — один файл на единицу хранения с именем, являющимся контрольной суммой 
содержимого и заголовка. Первые два символа 5НА определяют подкаталог файла, остальные 
38 — собственно, имя. 

Получить обратно содержимое объекта можно командой саіі-^ііе. Это своеобразный 
швейцарский армейский нож для проверки объектов в СіГ. Ключ - р означает автоматическое 
определение типа содержимого и вывод содержимого на печать в удобном виде: 

$ діг. саи-тііе -р сІ67Ѳ46ѲЬ4Ь4аесе5915са1 = 5с68сІ121 = 56Ѳа91 = еЗе4 
Г.езг. сопГ.еп1: 



Теперь вы умеете добавлять данные в СіГ и извлекать их обратно. То же самое можно 
делать и с файлами. Рассмотрим пример. Наиболее простой контроль версий файла можно 
осуществить, создав его и сохранив в базе: 



$ есИо 'ѵегзіоп 1' > Іезі.іхі: 
$ діі ИазИ-оЬзесі -и ІезІ.ЬхІ: 
83Ьаае618Ѳ4е65сс73а7201а725275Ѳс76066аЗѲ 




Теперь изменим файл и сохраним его в базе ещё раз: 
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$ есИо 'ѵегзіоп 2' > Іезі.іхі 
$ діі ИазИ-оЬ^есІ: -и ІезИхІ: 
1г'7а7а472аЬт'ЗсШ643г'с1615г'6с)а379с4асЬЗеЗа 




Теперь в базе содержатся две версии файла іеаі.Ш, а также самый первый сохранённый 
объект: 

$ ■ріпсі .дИ/оЬоесіз -Ьуре Т 

.діИ/оЬзесИз/ІГ/УаУаДУгаЫЗсІсІЭбДЗГсІбІбГбсіаЗУЭсДасЬЗеЗа 
.діИ/оЬзес1:з/83/Ьаае618Ѳ4е65сс73а7201а7252750с76066аЗѲ 
.діИ/оЬзес1:5/сІ6/70460Ь4Ь4аесе5915са1 ; 5с68сЛ21 = 560а91 = еЗе4 



Теперь можно откатить файл к его первой версии: 



$ діі саи-тііе -р 83Ьаае61804е65сс73а7201а7252750с76066а30 > СезИ.Ихі 
$ саі СезИ.Их!: 
ѵегзіоп 1 




или второй: 

$ діі саИ-Ше -р 1г'7а7а472аЬг'ЗсІсІ9643т'сі615г"6сІа379с4асЬЗеЗа > СезИ.ИхІ: 
$ саі СезИ.Их!: 
ѵегзіоп 2 



Однако запоминать хеш для каждой версии неудобно, к тому же теряется само имя файла, 
сохраняется лишь содержимое. Объекты такого типа называют блобами (англ. Ьіпагу 1аг§е 
оЬіесі). Имея 5НА-1 объекта, можно попросить СіГ показать нам его тип с помощью команды 
са1:-гі1е -V. 

$ діИ саИ-Ше -I 11=7а7а472аЫ = ЗсісІ96431 ; сі6151 = 6сІа379с4асЬЗеЗа 
ЫоЬ 



9.2.1 Объекты-деревья 

Рассмотрим другой тип объектов СіІ — деревья. Они решают проблему хранения имён 
файлов, а также позволяют хранить группы файлов вместе. Система хранения данных СіІ 
подобна файловым системам ІШІХ в упрощённом виде. Содержимое хранится в объектах- 
деревьях и блобах, дерево соответствует записи каталога в ФС, а блоб более или менее соответствует 
іпосіе или содержимому файла. Объект -дерево может содержать одну и более записей, каждая 
из которых представляет собой набор из 5НА-1 хеша, соответствующего блобу или поддереву, 
режима доступа к файлу, типа и имени файла. Например, в проекте 5Ітр1е§іГ дерево на момент 
написания выглядит так: 
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$ діі саіі-^ііе -р таз(:ег Л {1:гее} 

1ѲѲ644 ЫоЬ а9Ѳ6сЬ2а4а9Ѳ4а152е8Ѳ877сі4Ѳ88654сІаасІ0с859 РЕАОМЕ 

1ѲѲ644 ЫоЬ 8г"941393381 = 94Ѳ4т"26296Ьет'а88755г"с2598с289 КакеГІІе 

04ѲѲ00 ігее 99г'1а6сІ12сЬ4Ь6-р19с8655г'са46сЗесг"317074е0 ІіЬ 



Запись т а 5 1: е г " { 1: г е е } означает объект-дерево, на который указывает по следний коммит 
ветки шазііег. Заметьте, что подкаталог ІІЬ — не блоб, а указатель на другое дерево: 

$ діИ саи-тііе -р 99г'1а6а , 12сЬ4Ь6г'19с8655г'са46сЗест'317074е0 

100644 ЫоЬ 47с6340СІ6459е05787г'644с2447сІ2595г"5сІЗа54Ь ЗІтрІедІИ . гЬ 



Схематически, данные, которые хранятся в Сіі, выглядят примерно так, как это изображено 
на рисунке 9-1. 



г гее 





КЕАРМЕ 


КакеГіІе 


ІгЬ 








N. 


ЫоЬ 




ЫоЬ 




ггее 



зітрІедгІ.гЬ 



ЫоЬ 



Рисунок 9.1: Упрощённая модель данных Сіі. 



Вручную можно создавать не только блобы, но и деревья. Сіі обычно создаёт дерево 
исходя из состояния индекса и затем сохраняет соответствующий объект-дерево. Поэтому для 
создания объекта-дерева необходимо проиндексировать какие-нибудь файлы. Для создания 
индекса из одной записи — первой версии файла іехі.ш, воспользуемся командой ирсіаііе- 
іпсіех. Данная команда может искусственно добавить более раннюю версию іезі.ш в новый 
индекс. Необходимо передать опции - -асісі, т.к. файл ещё не существует в индексе (да и 
самого индекса ещё нет), и - -сасНеігтРо, т.к. добавляемого файла нет в рабочем каталоге, 
но он есть в базе данных. Также необходимо передать режим доступа, хеш и имя файла: 



$ діі ирсіаііе-іпсіех — асісі - -сасИеігтРо 100644 \ 

83Ьаае61804е65сс73а7201а7252750с76066а30 іезС . ИхИ 



В данном случае режим доступа — 100644, что означает обычный файл. Другие возможные 
варианты: 100755 — исполняемый файл, 120000 — символическая ссылка. Режимы доступа 
в Сіі сделаны по аналогии с режимами доступа в ІШІХ, но они гораздо менее гибки: данные 
три режима — единственные доступные для файлов (блобов) в СіІ (хотя существуют и другие 
режимы используемые для каталогов и подмодулей). 
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Теперь можно воспользоваться командой мгіЪе-Ъгее для сохранения индекса в объект- 
дерево. Здесь опция -м не требуется — вызов Іл/гі1:е-1:гее автоматически создаст объект- 
дерево по состоянию индекса, если такого дерева ещё не существует: 

$ діі ыгі1:е-1:гее 

а , 8329г'с1сс938780гТсІсІ9г'94е0а , 364е0еа74т'579 

$ діИ саИ-гіІе -р СІ8329т'с1СС938780гТа , а , 9т"94е0СІ364е0еа74т579 

10Ѳ644 ЫоЬ 83Ьаае618Ѳ4е65сс73а7201а725275Ѳс76Ѳ66а30 ИезССхИ 



Также можно проверить, что мы действительно создали объект-дерево: 



$ діі саі-тііе -I сІ8329т'с1сс938780гТа , а , 91 = 94е0сІ364е0еа74-р579 
Ігее 



Создадим новое дерево со второй версией файла Гекі.Ш и ещё одним файлом: 



$ есЬо 'пей т"і1е 1 > пем.1:х1: 
$ діі ирсіа1:е-іпсіех ІезИхІ: 
$ діі ирсіаііе-іпсіех — асісі пей. 1x1: 




Теперь в индексе содержится новая версия файла іезі.Ш и новый файл пе\ѵ.Ш. Запишем 
это дерево (сохранив состояние индекса в объект-дерево) и посмотрим, что из этого получилось: 

$ діі игНе-Ьгее 

0155еЬ4229851634а0г'03еЬ265Ь69г"5а2сІ56г'341 
$ діИ саИ-Ше -р 0155еЬ4229851634а0т'03еЬ265Ь69г'5а2а , 56г'341 
100644 ЫоЬ Га49Ь077972391аа , 58037050т'2а75т74е3671е92 пеи.СхИ 
100644 ЫоЬ 1т7а7а472аЬт'За , сІ9643г'сІ615т'6а , а379с4асЬЗеЗа ИезССхИ 

Заметьте, что в данном дереве находятся записи для обоих файлов, а также, что хеш файла 
(Е5І.Ш это хеш «второй версии» этого файла (1^7 &7 а). Для интереса, добавим первое дерево 
как подкаталог для текущего. Зачитать дерево в индекс можно командой геасІ-1:гее. В 
нашем случае, чтобы прочитать уже существующее дерево в индекс и сделать его поддеревом, 
необходимо использовать опцию - - рге'Пх: 

$ діі геагі-Игее - -ргегіх=Ьак сІ8329г'с1сс938780гТсІа , 9т'94е0сІ364е0еа74т579 
$ діі игНе-Ьгее 

Зс4е9ссІ789а , 88а , 8сІ89с1073707с3585е41Ь0е614 
$ діИ саГ-Ше -р Зс4е9ссІ789а , 88а , 8сІ89с1073707с3585е41Ь0е614 
040000 ігее а , 8329гс1сс938780гТа , а , 9г'94е0а , 364е0еа74т'579 Ьак 
100644 ЫоЬ •Га49Ь077972391асІ58037050-Г2а75т74е3671е92 пеи.СхИ 
100644 ЫоЬ 1т7а7а472аЫ = За , а , 9643г"сІ615г'6а , а379с4асЬЗеЗа ИезССхИ 
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Если бы вы создали рабочий каталог, соответствующий только что созданному дереву, вы 
бы получили два файла в корне и подкаталог Ьак со старой версией файла іезі.Ш. Данные, 
которые хранит СіІ для такой структуры, представлены на рисунке 9-2. 



Зс4с9с 

ггее 



пеѵѵ.ѣхѣ Іезѣ.ѣхѣ Ьак 
г" ♦ 



<Ъ49Ьв 

"пеѵѵ Ые" 



1Ш7а 

"ѵегзіоп 2" 



<яъгъі 
Ігее 



Іезѣ.ѣхі: 
I 



83Ьаае 

"ѵегзіоп 1 " 



Рисунок 9.2: Структура данных Сіі для текущего дерева. 



9.2.2 Объекты-коммиты 

У нас есть три дерева, соответствующих разным состояниям проекта, но предыдущая 
проблема с необходимостью запоминать все три значения 5НА-1, чтобы иметь возможность 
восстановить какое-либо из этих состояний, ещё не решена. К тому же у нас нет никакой 
информации о том, кто, когда и почему сохранил их. Такие данные — основная информация, 
которая хранится в объекте-коммите. 

Для создания объекта-коммита необходимо вызвать соттіі: - X. г ее и задать 5НА-1 нужного 
дерева и, если необходимо, родительские объекты-коммиты. Для начала создадим коммит для 
самого первого дерева: 



$ есНо Тігзі: соттіі 1 | діС соттлЛ-Ігее сІвзгэ^Г 
ГсІГДГсЗЗДДебУаЬѲбЗГВЗбвУвЬбсДЭБІеЗЫб-ГЗсІ 



Просмотреть вновь созданный объект-коммит можно командой саЪ-'РИе: 



$ діі саИ--Гі1е -р МІМтсЗ 

Игее с18329-Гс1сс93878Ѳ-Г-Гсісі91 = 94еѲс1364еѲеа741 = 579 

аиіИог 5соИ1: СИасоп <зсІіасоп§дтаі1.сопі> 1243Ѳ40974 -0700 

соміиег ЗсоИ СНасоп <зсИасоп§дтаі1 . сот> 1243040974 -070Ѳ 

■Гігзі: соттіі: 



Формат объекта-коммита прост: в нём указано дерево верхнего уровня, соответствующее 
состоянию проекта на некоторый момент; имя автора и коммитера берутся из полей конфигурации 
изег . пате и изег . етаіі; также добавляется текущая временная метка, пустая строка и 
затем сообщение коммита. 
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Далее, создадим ещё два объекта-коммита, каждый из которых будет ссылаться на предыдущий 



коммит: 


$ есИо 'зесопсі соттіі ' | дИ соттіі-іігее 0155еЬ -р 

сас0саЬ538Ь970а37еа1е769сЬЬсіе608743Ьс96сі 

$ есИо '1:НігсІ соттіі ' | діі соттіі-іігее Зс4е9с -р 

1а410ег'ЬсЛ3591сШ07496601еЬс7а059сІсІ55ст'е9 


ТдГЛТсЗ 
сасОсаЬ 


Каждый из трёх объектов-коммитов указывает на одно из состояний проекта. Может 


показаться странным, но теперь у нас есть полноценная СіГ-история, которую можно посмотреть 


командой діі: Іод, указав хеш последнего коммита: 




$ діі Іод --зНаИ 1а410е 

соттіС 1а410ег"ЬсІ13591сіЬ07496601еІэс7а059сісі55сге9 
Аи1:Мог: ЗсоЫ: СИасоп <зсНасоп§дтаі1.сот> 
Оаіе: Ргі Мау 22 18:15:24 2009 -0700 




ІМігсІ соттіі: 




Ьак/іезИ.ИхІ: | 1 + 

1 -Гііез сИапдесі, 1 іпзег1:іопз( + ) , 0 с!е1е1:іопз( - ) 




соттіі сас0саЬ538Ь970а37еа1е769сЬЬсІе608743Ьс96сІ 
АиІіИог: ЗсоЫ: СИасоп <зсИасоп§дтаі1.сот> 
Оаіе: Ргі Мау 22 18:14:29 2009 -0700 




зесопсі соттіі: 




пеи.(:х(: | 1 + 
ИезИ.іхИ | 2 +- 

2 -Гііез сНапдесІ, 2 іпзег1:іопз( + ) , 1 с!е1е1:іопз( - ) 




соттіі г'с1т'4г'с3344е67аЬ068-Г836878Ь6с4951еЗЫ5г'ЗсІ 
Аи1:Мог: ЗсоЫ: СИасоп <зсИасоп§дтаі1.сот> 
Оаіе: Ргі Мау 22 18:09:34 2009 -0700 




■рігзі: соттіі: 




ИезИ.іхІ: | 1 + 

1 -Гііез сііапдесі, 1 іпзег1:іопз( + ) , 0 йе1е1:іопз( - ) 





Поразительно. Мы только что выполнили низкоуровневые операции для построения истории 
без использования высокоуровневых интерфейсов. По существу, именно это делает СіІ, когда 
выполняются команды діі асІСІ и діі сотшіі: — сохраняет блобы для изменённых файлов, 
обновляет индекс, записывает объекты-деревья и коммит-объекты, ссылающиеся на объекты- 
деревья верхнего уровня и предшествующие коммиты. Эти три основных вида объектов в 
Сіі: блоб, дерево и коммит — сначала сохраняются как отдельные файлы в каталоге . діі/ 
оЬзесІіз. Вот все объекты, которые сейчас лежат в каталоге с примером (в комментариях 
написано чему объекты соответствует): 
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$ ■ГіпсІ . діІі/оЬзесіз -іуре Т 

.діі/оЬ]есГ.з/01/55еЬ4229851634а0г'03еЬ265Ь69г"5а2сІ56т'341 # Ггее 2 

.діі/оЬзес1:з/1а/410егЪгі13591сІЬ07496601еЬс7а059сІсІ55ст'е9 # соттіг. 3 

.ді(ѴоЬзес1:5/11Ѵ7а7а472аЬ1 = За , а , 9643г'а'615г'6а , а379с4асЬЗеЗа # ИезСПхг. ѵ2 

.ді1:/оЬ]есГ.з/Зс/4е9ссІ789а88сІ8сІ89с:і.073707с3585е41ЬѲе614 # Игее 3 

.діІ/оЬзесг.5/83/Ьаае618Ѳ4е65сс73а72Ѳ1а7252750с76066аЗѲ # СезСПхг. ѵі 

.діІ/оЬзес1:5/са/с0саЬ538Ь97Ѳа37еа1е769сЬЬсІе6Ѳ8743Ьс96сІ # соттіг. 2 

.діі/оЬзесГ.з/сІ6/70460Ь4Ь4аесе5915сат'5с68сІ12г"560а9т'еЗе4 # 'іезг. сопИепС 

.діі/оЬ]есГ.з/а'8/3291 = с1сс938780гТа'а , 9т'94еѲа , 364е0еа74т'579 # Игее 1 

. діЬ/оЬзесГз/-Га/49Ь077972391асІ58037Ѳ5Ѳг"2а75г74е3671е92 # пеы. Схг. 

.діІ/оЬзес1:з/-ГсІ/1 = 41 = с3344е67аЬѲ681 = 836878Ь6с4951еЗЫ5-ГЗс) # соттіг. 1 



Если пройти по всем внутренним ссылкам, получится граф объектов такой, как на рисунке 



9-3. 
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Рисунок 9.3: Все объекты в репозитории Сіі. 



9.2.3 Хранение объектов 

Ранее я упоминал, что заголовок сохраняется вместе с содержимым. Давайте посмотрим, 
как сохраняются объекты Сіі на диске. Мы рассмотрим сохранение блоб-объекта, в данном 
случае это будет строка «есть проблемы, шеф?». Пример будет выполнен на языке КиЬу. Для 
запуска интерактивного интерпретатора воспользуйтесь командой ІГ Ь: 



$ ігЬ 

» сопіепі: = "есть проблемы, шеф?" 
=> "есть проблемы, шеф?" 



Сіі создаёт заголовок, начинающийся с типа объекта, в данном случае это блоб. Далее 
добавляется пробел, размер содержимого и в конце нулевой байт: 



» пеасіег = "ЫоЬ #{соп!:епС . 1епдіп}\0" 
=> "ЫоЬ 34X000" 
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Сіі дописывает содержимое после заголовка и вычисляет 5НА-1 сумму для полученного 
результата. В КлЪу значение 5НА-1 для строки можно получить, подключив соответствующую 
библиотеку командой гедиігеи затем во спользовавшись вызовом Оідезі:: : 5 Н А1 . п е х сі і д е 5 1: ( ) : 

» зЬоге = Ііеасіег + сопГеп!: 

=> "ЫоЬ 34\Ѳ0О\320\225\321\2Ѳ1\321\202\321\214 \32Ѳ\277\321\2Ѳ0\320\276\32Ѳ\261\320\273\320\265\32Ѳ\274\ 
» гериіге 'сіідезіі/зііаі' 
=> ігие 

» зНаІ = Оідезі : :5НА1. НехсЛдез1:(з(:оге) 

=> "с18а734г'44240Ьс1г'766с8сЛ = 342664г'с1е23с)421с164" 



СіГ сжимает новые данные при помощи 2ІіЬ, что решается в КиЬу соответствующей библиотекой. 
Сперва, необходимо подключить её, а после вызвать 2ІІЬ : : Ое^іаііе . сіе1 = 1а1:е( ) сданными 
в качестве параметра: 

» гериіге '2ІІЬ' 
=> ігие 

» 2ІіЬ_соп1:еп1: = 21іЬ: :Ре'Г1а1:е.сІе'Г1а1:е(з1:оге) 

=> "х\234\0Ѳ1*\000\325\377ЫоЬ 34\000\320\225\321\201\321\202\321\214 \320\277\321\200\320\276\320\261\32 
\3453\0305" 



После этого, запишем сжатую 2ІіЬ'ом строку в объект на диск. Определим путь к файлу, 
который будет записан (первые два символа хеша используются в качестве названия подкаталога, 
оставшиеся 38 — в качестве имени файла в этом каталоге). В КлЪу для этой задачи можно 
использовать функцию РІ1еІІ1:ІІ5 . шксІіг_р ( ) для создания подкаталога, если он не существует. 
Далее, откроем файл вызовом Рііе . о реп ( ) и запишем наши сжатые данные вызовом м г і 1: е ( ) 
для полученного файлового дескриптора: 

» раіИ = ' .діИ/оЬзесіз/' + зИа1[0,2] + V + зИа1[2,38] 
=> " .діі/оЬзес1:з/сІ8/а734-Г44240ЬсІ1 = 766с8сЛ = 3426641 ; сІе23сі421сІ64" 
» гериіге ' 'Гііеиіііз ' 
=> ігие 

» РіІеІЛііІз . тксІіг_р(Рі1е . сіігпате(ра1:И) ) 
=> " .діі/оЬзесИз/Ьсі" 

» Рі1е.ореп(ра1:М, 'ь/') { \Т\ Т .мгі1:е 2ІіЬ_соп(:еп1: } 
=> 32 




Вот и всё, мы создали корректный объект-блоб для Сіі. Все другие объекты создаются 
аналогично, меняется только запись о типе в заголовке (ЫоЬ, соттіі:, Ігее). Стоит добавить, 
что хотя в блобе может храниться почти любое содержимое, содержимое объектов-деревьев и 
объектов-коммитов записывается в очень строгом формате. 



9.3 Ссылки в Сіі 

Для просмотра всей истории можно выполнить команду вроде діі. Іод 1а410е, но, 
опять же, требуется помнить, что именно коммит 1а410е является последним, чтобы иметь 
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возможность найти все наши объекты. Нам нужен файл-указатель с простым именем, который 
бы содержал это значение хеша 5НА-1, чтобы можно было пользоваться этим файлом вместо 
хеша. 

В Сіі такие файлы, содержащие 5НА-1, называются ссылками («гегз») и располагаются 
в каталоге . діі/геТз. В нашем проекте этот каталог пока пуст, но в нём уже существует 
некоторая структура каталогов: 

$ ■ріпсі . дИ/ге'Гз 

. діі/ге-рз 

. діІ/ге^з/НеасІз 

. діі/ге-рз/ііадз 

$ -ГіпсІ .діІі/ге-Гз -1:уре Т 

$ 



Чтобы создать новую ссылку, которая поможет вам вспомнить, какой коммит последний, 
по сути, необходимо сделать всего лишь следующее: 

$ есИо "1а41Ѳе1 = ЬсІ13591йЬѲ74966Ѳ1еІэс7аѲ59с1с155сг'е9" > . діИ/гегз/Иеасіз/тазіег 



Теперь можно использовать только что созданную ссылку из каталога Ьеасів вместо хеша 
в командах Сіі: 



$ діі Іод - -рге11:у=опе1іпе тазіег 






1а41Ѳег'Ьсі13591сІЬѲ74966Ѳ1еЬс7аѲ59сІсІ55ст'е9 




соттіі: 


сасѲсаЬ538Ь97Ѳа37еа1е769сЬЬсіе6Ѳ8743Ьс96сі 


зесопгі 


соттіі: 


г'сІг'4г'с3344е67аЬѲ68г'836878Ь6с4951еЗЫ5т'Зсі 


ГІГЗЬ 


соттіі: 



Тем не менее, редактировать данные файлы напрямую не рекомендуется. СіІ предоставляет 
безопасную команду ирсіаііе - геТ для изменения ссылок: 

$ діі иргіаИе-гег' гегз/НеасІз/тазІіег 1а410етЪсІ13591с1ЬѲ74966Ѳ1еЬс7аѲ59с1сІ55сг'е9 



Вот что такое по сути ветка в Сіі — простой указатель или ссылка на последнюю версию в 
работе. Для создания ветки, соответствующей состоянию второго коммита, можно выполнить 
следующее: 



$ діі ирсІаІіе-ге-Г ге-рз/НеасІз/ІіезІ: сасѲса 




Данная ветка будет содержать только коммиты, предшествующие выбранному: 
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$ діі Іод - -ргеі1:у=опе1іпе іезі: 

сасѲсаЬ538Ь97Ѳа37еа1е769сЬЬсІе6Ѳ8743Ьс96сі зесопсі соттіг. 
г'сІг'4г'с3344е67аЬѲ68г'836878Ь6с4951еЗЫ5т'ЗсІ гігзС соттіі: 



Теперь наша база данных СіІ схематично выглядит так, как показано на рисунке 9.4. 



ге(5/Ьеэд5/та51ег 



іЬіггі соттіг 




ют 
(гее 










зесопгі соттіі 




•іил 
(гее 











- пеи.іх* - 
кез(ЛхІ 



(ехі.іхі 
" пе*».(х( 





ІШТо 




"ѵегііоп 2" 







мм* 




мм 






Лг8( соттЛ 




(гее 


— *е« . іх* — » 


"ѵегеюп 1 " 



V 



Рисунок 9.4: Объекты в каталоге .діі, а также указатели на вершины веток. 



Когда выполняется команда діг_ ЬгапсИ (имя ветки), Сіі, по сути, выполняет 
ирсІа1:е-гег" для добавления хеша последнего коммита текущей ветки под указанным именем 
в виде новой ссылки. 



9.3.1 НЕАБ 

Вопрос в том, как же Сіі получает хеш последнего коммита при выполнении діг_ ЬгапсИ 
(имя ветки)? Ответ содержится в файле НЕАБ. Данный файл является символической 
ссылкой на текущую ветку. Символическая ссылка отличается от обычной тем, что она содержит 
не сам хеш 5НА-1, а указатель на другую ссылку. Если вы загляните в этот файл, то увидите 
что-то такое: 



$ саі . діИ/НЕАО 

геТ: ге^з/НеасІз/тазІіег 



Если выполнить діг_ сНескоиг. г_ е 5 г_, то содержимое файла изменится: 



$ саі . діИ/НЕАО 
гет': ге^з/ИеасІз/Ііезі 



При выполнении діг_ сотшіі:, Сіі создаёт объект-коммит, указывая его родителем тот 
объект, 5НА-1 которого содержится в файле, на который ссылается НЕАБ. 

Данный файл, конечно, можно редактировать вручную, но безопаснее использовать команду 
зушЬоІіс - г ет\ Получить значение НЕАБ данной командой можно так: 
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$ діі зутЬоІіс-ге-Г НЕАР 
ге-рз/Пеайз/тазСег 



Изменить значение НЕАБ можно так: 

$ діі зутЬоНс-ге'Г НЕАР ге^з/ИеасІз/ІіезІ: 
$ саі . діИ/НЕАО 
ге-Г: ге-Гз/Иеасіз/іезІ: 

Символическую ссылку на файл вне гегз поставить нельзя: 

$ діі зутЬоІіс-ге-Г НЕАЭ 1:ез1: 

■Гаіаі: Ке^Гизіпд Іо роіпі: НЕАР оиізісіе о'Г геТв/ 



9.3.2 Метки 

Мы рассмотрели три основных типа объектов в Сіі, но есть и четвёртый. Объект-метка 
очень похож на объект-коммит: он содержит имя поставившего метку, дату, сообщение и 
указатель. Разница же в том, что метка указывает на коммит, а не на дерево. Она похожа 
на ветку, которая никогда не перемещается — она всегда указывает на один и тот же коммит, 
она просто даёт ему понятное имя. 

Как было сказано в главе 2, метки бывают двух типов: аннотированные и легковесные. 
Легковесную метку можно сделать следующей командой: 

$ діі ирсІаИе-гег' гегз/Иадз/ѵІ . Ѳ сасѲсаЬ538Ь970а37еа1е769сЫэсІе6Ѳ8743Ьс96сІ 



Вот и всё! Легковесная метка — это ветка, которая никогда не перемещается. Аннотированная 
метка имеет более сложную структуру. При создании аннотированной метки, Сіт создаёт 
специальный объект, на который будет указывать ссылка, а не просто указатель на коммит. 
Мы можем увидеть это создав аннотированную метку ( - а задаёт аннотированные метки): 



$ діі Сад -а ѵі.1 1а41Ѳе1=ЬсЛ3591сІЬ074966Ѳ1еЬс7а059сісі55с1 = е9 -т 'Пев! Сад' 




Вот значение 5НА-1 созданного объекта: 



$ саі .ді^/ге-рз/іадз/ѵі.і 
95851911=371 ; 7Ь01 = Ь9444Г35а9Ы = 5Ѳсіе191Ьеасіс2 




Теперь выполним саіі-^ііе для этого хеша: 
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$ діі саИ-Ше -р 9585191т"37г'7Ь0г'Ь94441 = 35а9Ы = 50сІе191ЬеасІс2 
оЬ] есС 1а410ег'ЬсІ13591а , Ь07496601еЬс7а059а , а , 55сге9 
т:уре соттіі: 
1:ад ѵі.1 

Г.аддег ЗсоШ: СИасоп <зсНасоп§дтаі1 . сот> 5аИ Мау 23 16:48:58 2Ѳ09 -0700 
г.е51 (:ад 



Заметьте, в поле оЬіесі записан 5НА-1 коммита, для которого мы делали метку. Также 
стоит отметить, что это поле не обязательно указывает на коммит, но на любой объект в С-іГ. 
Например, в исходный код С-іГ мейнтейнер добавил свой открытый СРС-ключ в качестве блоба 
и поставил для него метку. Увидеть этот ключ можно, выполнив команду 

$ діі са^-рИе ЫоЬ ;іипіо-дрд-риЬ 



в репозитории с исходным кодом Сіі. В репозитории ядра Ыгшх также есть метка, указывающая 
не на коммит — первая метка указывает на дерево первичного импорта. 

9.3.3 Ссылки на удалённые ветки 

Третий тип ссылок, который мы рассмотрим — ссылка на удалённую ветку. Если вы 
добавили удалённый репозиторий и отправили (ризЬ) на него изменения, СіІ сохранит последнее 
отправленное значение 5НА-1 в каталоге г е'Рз/ г етог-ез для всех отправленных веток. Например, 
можно добавить удалённый репозиторий огідіп и отправить туда ветку та5Г_ег: 

$ діі гето1:е асісі огідіп ді1:§ді1:НиЬ.сот:зсНасоп/зітр1еді1:-ргоді1:.ді1: 

$ діі ризИ огідіп тазіег 

Соипіііпд оЬзес1:з: 11, сіопе. 

Сотргеззіпд оЬ^есЪз: 100% (5/5), йопе. 

ЫгіСіпд оЬзесИз: 100% (7/7), 716 ЬуНез, йопе. 

Тоіаі 7 (сІеИа 2), геизесі 4 (сІеІЬа 1) 

То ді(:§ді1:НиЬ.сот:зсПасоп/5ітр1еді(:-ргоді1: .ді(: 



а11Ье-Г0 . . са82а6сі таз1:ег -> тазіег 




Позже, вы сможете посмотреть где находилась ветка таз г. е г с сервера огідіп во время 
последнего соединения с сервером заглянув в файл ге^з/гетог.ез/огідіп/тазг.ег: 

$ саЬ . дИ/ге^з/гетоІіез/огідіп/тазІіег 
са82а6СІгТ817ес66г"44342007202690а93763949 

Ссылки на удалённые ветки отличаются от обычных веток (ссылки в гег"5/гіеасІ5) тем, 
что на них нельзя переключиться с помощью діг. сНескоиг.. Сіі работает с ними как с 
закладками, указывающими на последнее состояние соответствующих веток на ваших серверах. 
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9.4 Раск-файлы 



Вернёмся к базе объектов в нашем тестовом репозитории. К этому моменту их должно 
быть 11 штук: 4 блоба, 3 дерева, 3 коммита и одна метка: 



$ -ГіпсІ . діІі/оЬзесіз -іуре Т 






.ді1:/оЬз'ес1:5/01/55еЬ4229851634а0г03еЬ265Ь69г5а2сІ56т'341 


# 


ігее 2 


. діі/оьз есіз/іа/ 4іѳетоаізь9іаиѲ / 49ЬЬ0іеьс /аѳь9сш55сте9 


# 


соттіі: 3 


.діИ/оЬз ес1:5/1г/7а7а472аЬгЗсі 0'9643гсІ615т'6а , а379с4асЬЗеЗа 


# 


ИезС.ИхИ ѵ2 


.ді1:/оЬз'ес1:5/Зс/4е9ссІ789а , 88а , 8а , 89с1073707с3585е41Ь0е614 


# 


ігее 3 


.діИ/оЬзес1:з/83/Ьаае618Ѳ4е65сс73а7201а7252750с76066аЗѲ 


# 


Іезі.іхі ѵі 


.ді1:/оЬзес1:з/95/85191г37т'7Ь0гЬ9444г35а9Ьт'50сІе191Ьеаа , с2 


# 


Сад 


.діі/оЬзес1:з/са/сѲсаЬ538Ь97Ѳа37еа1е769сЬЬсіе6Ѳ8743Ьс96сі 


# 


соттіі: 2 


.ді1:/оЬзес1:з/сІ6/7Ѳ46ѲЬ4Ь4аесе5915са1 = 5с68сЛ2-Г560а91 = еЗе4 


# 


Чезі: сопЬепС 


.ді1:/оЬз'ес1:5/а , 8/329гс1сс938780ггсІсІ9т'94еѲа , 364е0еа74т'579 


# 


Ігее 1 


.ді1:/оЬзес1:5/га/49Ь077972391асІ5803705Ѳт'2а75г74е3671е92 


# 


пей. (:х1: 


.ді!:/оЬзес1:з/1 = сІ/-Г4Гс3344е67аЬ0681 ; 836878Ь6с4951еЗЫ51 = Зс) 


# 


соттіі: 1 



Сіі сжал содержимое этих файлов при помощи 2ІіЬ, к тому же мы не записывали много 
данных, поэтому все эти файлы вместе занимают всего 925 байт. Для того, чтобы продемонстрировать 
одну интересную возможность СіГ, добавим файл побольше. Добавим файл геро.гЬ из библиотеки 
Сгіі, с которой мы работали ранее, он занимает примерно 12 Кбайт: 

$ сигі ИПр : //дііЬиЬ . сот/тозотЬо/дгі1:/гаи/таз(:ег/1іЬ/дгі1:/геро . гЬ > геро.гЬ 

$ діі асісі геро . гЬ 

$ діі соттіі: -т 'асісіесі геро.гЬ 1 

[тазЬег 484а592] асісіесі геро.гЬ 

3 -Гііез сЬапдесІ, 459 іпзег1:іопз( + ) , 2 сІе1е1:іопз( - ) 
сіеіеіе тосіе 100644 Ьак/ИезИ . ИхИ 
сгеаііе тосіе 100644 геро.гЬ 
геигііе ИезИ.ИхИ (100%) 



Если мы посмотрим на полученное дерево, мы увидим значение 5НА-1, которое получил 
блоб для файла геро.гЬ: 



$ діі са1:--рі1е -р тазіег л {1:гее} 






100644 ЫоЬ га49Ь077972391аа , 58037050т2а75т74е3671е92 


пей. 


іхИ 


100644 ЫоЬ 9Ьс1сІс421сІссІ51Ь4ас296еЗе5Ь6е2а99сг44391е 


геро 


. гЬ 


100644 ЫоЬ еЗг094г522629ае358806Ы7сІат78246с27с007Ь 


Иезі 


.ІХИ 



Для определения размера этого объекта воспользуемся командой діі саі: - 1 = і1е: 



$ діі саі-тііе -з 9Ьс1сіс421сіссІ51Ь4ас296еЗе5Ь6е2а99с1 = 44391е 
12898 




Теперь изменим немного данный файл и посмотрим на результат: 
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$ есЬо '# Іезііпд' » геро.гЬ 
$ діі соттіі: -ат 'тосіі^іесі геро а Ыі. ' 
[тазіег аЫаТеТ] тосіі-ріесі геро а Ьіт: 
1 -Гііез сЬапдесі, 1 іпзег1:іопз( + ) , Ѳ сіе1е1:іопз( - ) 



Взглянув на дерево полученное в результате коммита, мы увидим любопытную вещь: 



$ діі са1:--Гі1е -р тазіег л {1:гее} 




1ѲѲ644 ЫоЬ г"а49Ь077972391аа'58037050т'2а75т74е3671е92 


пей. 1x1: 


1Ѳ0644 ЫоЬ Ѳ5408сІ195263сі853г"09сІса71СІ55116663690с27с 


геро . гЬ 


1ѲѲ644 ЫоЬ еЗг"094г'522629ае358806Ы7а , ат'78246с27с007Ь 


Гезі . СхИ 


Теперь файлу геро.гЬ соответствует другой объект-блоб. 


Это означает, что даже одна 


единственная строка добавленная в конец 400-строчного файла требует создания абсолютно 


нового объекта: 





$ діі саі-тііе -З 05408сЛ95263сІ853г'09сіса71СІ5511666369Ѳс27с 
129Ѳ8 




Итак, мы имеем два почти одинаковых объекта по 12 Кбайт занимающих место на диске. 
Было бы неплохо, если бы СіІ сохранял только один объект целиком, а другой как разницу 
между ними. 

Оказывается, что Сіі так и делает. Первоначальный формат для сохранения объектов в 
СіГ называется рыхлым форматом (англ. Іооае !огтаГ) объектов. Однако, время от времени СіГ 
упаковывает несколько таких объектов в один раск-файл (раек в пер. с англ. — упаковывать, 
уплотнять) для сохранения места на диске и повышения эффективности. Это происходит, когда 
«рыхлых» объектов становится слишком много, а также при вызове діі дс вручную, и при 
отправке изменений на удалённый сервер. Чтобы посмотреть, как происходит упаковка, можно 
выполнить команду д і 1: д с : 

$ д±и дс 

СоипЬіпд оЬзесГз: 17, сіопе. 
Оеііа сотргеззіоп изіпд 2 1:ЬгеасІз. 
Сотргеззіпд оЬзесЬз: 1ѲѲ% (13/13), сіопе. 
Игіііпд оЬзесИз: 100% (17/17), сіопе. 
Тоіаі 17 (сіеІИа 1), геизесі 10 (сІеІСа 0) 



Если вы загляните в каталог с объектами, вы обнаружите, что большая часть объектов 
исчезла, зато появились два новых файла: 

$ -ГіпсІ . дИ/оЬзесЬз -іуре Т 

.ді[/оЬзесИз/71/081=7есЬ345ее9а , 0084193г'147са , аа , 4сІ2998293 
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.діі/оЬз'есІ:5/а , 6/7046ѲЬ4Ь4аесе5915сат'5с68а , 12г'560а9т'еЗе4 




. діІ/оЬзесІіз/ігтГо/раскз 




.діИ/оЬзесИз/раск/раск-7а16е4488ае4Ѳс7гі2Ьс56еа2М43е25212а66с45, 


, ІСІХ 


.ді1:/оЬзес1:з/раск/раск-7а16е4488ае4Ѳс7сі2Ьс56еа2Ьсі43е25212а66с45 1 


, раек 



Оставшиеся объекты — блобы, на которые не указывает ни один коммит. В нашем случае 
это созданные ранее объекты: содержащий строку «есть проблемы, шеф?», и блоб содержащий 
«іеві сопіепі». В силу того, что ни в одном коммите данные файлы не присутствуют, они 
считаются «висячими» и не упаковываются. 

Остальные файлы — это раск-файл и его индекс. Раск-файл — это файл, который теперь 
содержит все объекты, которые были удалены. А индекс — это файл, в котором записаны их 
смещения в раск-файле, что даёт возможность быстро найти нужный объект. Упаковка данных 
положительно повлияла на общий размер файлов, если до вызова дс они занимали примерно 
12 Кбайт, то раск-файл занимает всего 6 Кбайт. Упаковкой объектов мы смогли сократить 
место занятое на диске в два раза. 

Как СіІ это делает? При упаковке СіІ ищет файлы, которые похожи по имени и размеру 
и сохраняет только разницу между двумя версиями файла. Можно рассмотреть раск-файл 
подробнее и понять, какие действия были выполнены для сжатия. Для просмотра содержимого 
упакованного файла существует служебная команда діі ѵегігу- раек: 



$ діі ѵегі-ру-раск -ѵ \ 








.діГ/оЬзесИз/раск/раск-7а16е4488ае4Ѳс7гі2Ьс56еа2М43е25212а66с45.ісІх 


0155еЬ4229851634а01 ; 03еЬ265Ь69г'5а2сІ56т'341 


1:гее 


71 


76 5400 


05408с1195263а , 853г'09с1са71а , 55116663690с27с 


ЫоЬ 


12908 3478 874 


09г'01сеа5476661 = 58сІ6а8сІ809583841а7с6т'0130 


1:гее 


106 


107 5086 


1а410еГЬа , 13591а , Ь07496601еЬс7а059сІсІ55ст'е9 


соттіі 


225 


151 322 


11 = 7а7а472аЬт'Зс1с196431 = сІ615т'6сІа379с4асЬЗеЗа 


ЫоЬ 


10 


19 5381 


Зс4е9са , 789а , 88а , 8сІ89с1073707с3585е41ЬѲе614 


1:гее 


101 


105 5211 


484а59275031909е19аасІЬ7с92262719сг'саТ19а 


соттіі 


226 


153 169 


83Ьаае61804е65сс73а7201а7252750с76066а30 


ЫоЬ 


10 


19 5362 


9585191Г37-Г7Ь0ГЬ94441 ; 35а9Ы = 50СІе191ЬеасІс2 


Над 


136 


127 5476 


9Ьс1сІс421сІссі51Ь4ас296еЗе5Ь6е2а99с1 ; 44391е 


ЫоЬ 


7 18 5193 1 


05408с1195263а , 853г'09с1са71а , 55116663690с27с 


\ 






аЫагет'80Гас8е34258тТ411 = с1Ь867с702а , аа24Ь соттіИ 232 157 12 


сас0саЬ538Ь970а37еа1е769сЬЬа , е608743Ьс96а' 


соттіі 


226 


154 473 


сі8329Гс1сс938780ггсіс)9т'94е0сі364е0еа74г579 


1:гее 


36 


46 5316 


еЗГ0941 ; 522629ае358806Ы7сіа1 = 78246с27с007Ь 


ЫоЬ 


1486 734 4352 


г'8г'51сІ7сІ8а1760462еса26ееЬа-Га , е32087499533 


Сгее 


106 


107 749 


1=а49Ь077972391асІ58037050-Г2а75Г74е3671е92 


ЫоЬ 


9 18 856 


1 = СІГ4Гс3344е67аЬ0681 = 836878Ь6с4951еЗЫ51 ; Зсі 


соттіі 


177 


122 627 


сЬаіп 1епд1:Ь = 1: 1 оЬзесІ: 








раек- 7а16е4488ае40с7сІ2Ьс56еа2ЬсІ43е25212а66с45. раек: 


ок 



Здесь блоб ЭЬсІсІ, который, как мы помним, был первой версией файла геро.гЬ, ссылается 
на блоб 05408, который был второй его версией. Третья колонка в выводе — это размер 
объекта. Как видите, 05408 занимает в файле 12 Кбайт, при этом ЭЬсІСІ занимает всего лишь 
7 байт. Что интересно, вторая версия сохраняется «как есть», а исходная — в виде дельты. Это 
из-за того, что необходимость получения доступа к последней версии файла является более 



257 



Глава 9 Оіі изнутри 



Зсоіі СЬасоп Рго Сіі 



вероятной. 

Также здорово, что переупаковку можно выполнять в любое время. Время от времени 
СіІ будет выполнять её автоматически, чтобы сэкономить место на диске, если вдруг этого 
недостаточно, всегда можно выполнить діі: дс вручную. 

9.5 Спецификации ссылок 

Во всей книге использовались простые связи между ветками в удалённых репозиториях 
и локальными ветками, но они могут быть и более сложными. Предположим, мы добавили 
следующий удалённый репозиторий: 

$ дИ гептане асісі огідіп ді1:§ді1:НиЬ.сот:5сНасоп/5ітр1еді1:-ргоді1:.ді1: 



Данный вызов добавляет секцию в файл . дііі/сопгід, в которой заданы имя удалённого 
репозитория (огідіп), его ІЖЬ и спецификация ссылок для извлечения данных: 

[гетоіе "огідіп"] 

игі = ді1:§дііНиЬ.сот:5сНасоп/5ітр1еді1:-ргоді1:.ді1: 
Теі.сЬ = +гет"з/Пеайз/* : гет"з/гето1:е5/огідіп/* 



Формат спецификации следующий: опциональный +, далее пара <5 г с> : <СІ 5 {.>, где <5 г О — 
шаблон ссылок в удалённом репозиторий, а <СІ5І:> — соответствующий шаблон локальных 
ссылок. Символ + сообщает Сіі, что обновление необходимо выполнять даже в том случае, 
если оно не является перемоткой. 

В случае настроек по умолчанию, которые записываются во время выполнения діі г е - 
то1:е асісі, С-іг выбирает все ссылки из гег'з/Неайз/ на стороне сервера, и записывает их 
в локальный каталог ге^з/гетоііез/огідіп/. Таким образом, если на сервере есть ветка 
тазііег, журнал данной ветки можно получить, вызвав: 

$ діі Іод огідіп/тазіег 

$ діі Іод гето1:ез/огідіп/таз1:ег 

$ діі Іод ге-Гз/гетоЬез/огідіп/тазіег 



Все эти команды эквивалентны, так как С-іг развернёт каждую запись доге^з/гетоііез/ 
огідіп/шазііег. 

Если хочется, чтобы Сіі забирал при обновлении только ветку ша5І:ег,ане все доступные 
на сервере, можно изменить соответствующую строку в файле конфигурации на следующее: 

•ре1:сГі = +ге-Гз/Иеасіз/таз1:ег : ге-Гз/гето1:ез/огідіп/та5І:ег 



Данный гегзрес будет использоваться по умолчанию при вызове діі Теі.сЬ для данного 
удалённого репозитория. Если же вам нужно изменить спецификацию всего раз, можно задать 
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гегзрес в командной строке. Например, чтобы получить данные из ветки таз 1: е г из удалённого 
репозитория в локальную огідіп/тутазііег, можно выполнить 

$ діі ТеісЬ огідіп таз1:ег : ге^Гз/гетоІіез/огідіп/тутазІіег 



Конечно, можно задать несколько спецификаций. Получить данные нескольких веток из 
командной строки можно так: 

$ діі Теі.сЬ огідіп таз1:ег : ге^рз/гетоііез/огідіп/тутазііег \ 

Іоріс : ге-рз/гетоііез/огідіп/іоріс 
Ргот діі@ді1:НиЬ . сот : зсИасоп/ зітріедіі: 

! [^есГеа] таз1:ег -> огідіп/тутазіег (поп ■разі Тогѵіагб) 

* [пеы ЬгапсН] іоріс -> огідіп/1:оріс 



В данном случае, слияние ветки тазіег выполнить не удалось, поскольку слияние не было 
просто перемоткой. Такое поведение можно изменить, добавив перед спецификацией знак +. 

В конфигурационном файле также можно задавать несколько спецификаций для получения 
обновлений. Чтобы каждый раз получать обновления веток тавіег и ехрегітепі, добавьте две 
такие строки: 

[гетоіе "огідіп"] 

игі = ді1:§дііПиЬ.сот:5сНасоп/зітр1еді1:-ргоді1:.ді1: 

ТеісЬ = +ге^з/Пеаа , з/таз1:ег : ге^з/гетоіез/огідіп/тазііег 

ТеісЬ = +ге^з/Пеаа , з/ехрегітеп1: : ге^з/гетоіез/огідіп/ехрегітепі: 



Задавать частичные регулярные выражения в спецификации нельзя, следующая запись 
неверна: 

•ГеЬсМ = +ге-Гз/ИеасІз/ра* : ге-Гз/гетоіез/огідіп/да* 



Тем не менее, можно использовать пространства имён для получения похожего результата. 
Если имеется команда С} А (сокр. от диаіпу аззигапсе — контроль качества), которая использует 
свои несколько веток, и вы хотите получать только ветку тавіег и все ветки команды СА, а 
остальные — нет, то можно добавить в конфигурацию следующее: 

[гетоіе "огідіп"] 

игі = ді1:§дііНиЬ.сот:5сНасоп/зітр1еді1:-ргоді1:.ді1: 
■ре1:сН = +ге'Г5/Ііеасіз/таз1:ег : ге^з/гетоіез/огідіп/тазііег 
ТеісЬ = +ге-Гз/Иеасіз/да/* : ге-Гз/гето1:ез/огідіп/да/* 



Если ваш рабочий процесс является сложным, и разные команды: разработчики, тестеры, 
внедренцы — коммитят в разные ветки одного и того же проекта, то так вы с лёгкостью можете 
разделить их по разным пространствам имён. 
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Это хорошо, что мы научились получать данные по ссылкам в отдельных пространствах 
имён, но нам же ещё надо сделать так, чтобы команда С}А сначала смогла отправить свои ветки 
в пространство имён ^ а/. Мы решим эту задачу используя спецификации ссылок для команды 
ризп. 

Если разработчик из команды С} А хочет отправить изменения из локальной ветки таз 1: е г 
в да/таз1:ег на удалённом сервере, он может выполнить команду 

$ діі ризН огідіп тазіег : ге-Гз/ИеасІз/да/тазІіег 



Если хочется, чтобы Сіг автоматически делал так при вызове діі риз И огідіп, можно 
добавить в конфигурационный файл значение для риз И: 

[гетоіе "огідіп"] 

игі = ді1:§дііПиЬ.сот:5сНасоп/5ітр1еді1:-ргоді1:.ді1: 
ТеісЬ = +гег"з/ПеасІ5/* : гет"з/гето1:е5/огідіп/* 
ризИ = ге-Гз/Иеасіз/таз1:ег : ге-Гз/Иеасіз/да/таз1:ег 




Опять же, это приведёт к тому, что при вызове діі ризгі огідіп локальная ветка 
тазЁег будет по умолчанию отправляться в удалённую ветку да/шаз1:ег. 

9.5.2 Удаление ссылок 

Кроме всего прочего, спецификации ссылок можно использовать следующим образом для 
удаления ссылок на удалённом сервере: 

$ діі ризИ огідіп :іоріс 



Так как спецификация ссылки задаётся в виде <з г О : <с! з 1:>, опускание <5 г с> означает, 
что указанную ветку на удалённом сервере надо сделать пустой, что приводит к её удалению. 

9.6 Протоколы передачи 

СіГ может передавать данные между репозиториями одним из двух основных способов: 
через НТТР или через «умные» протоколы для транспортов 'Гііе : //, ззИ : // и діі : //. В 
данном разделе мы кратко рассмотрим как эти два протокола работают. 

9.6.1 Тупой протокол 

Сй-транспорт работающий по НТТР часто называют «тупым» протоколом, потому что 
для его работы во время передачи данных не требуется исполнения никакого СіІ-специфичного 
кода на стороне сервера. Процесс извлечения данных представляет собой последовательность 
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СЕТ-запросов, клиент обращается к стандартной структуре каталогов СіГ. Давайте рассмотрим 
процесс получения данных по НТТР на примере библиотеки 5ітр1е§іі: 

$ діі сіопе Н1:1:р://дііНиЬ.сот/зсПасоп/зітр1едіі-ргоді1:.ді1: 



Первое действие, выполняемое данной командой — загрузка файла ігтГо/ге^з. Данный 
файл записывается командой и рс! аі: е - 5 е г ѵе г - іп 'То, поэтому для использования НТТР-тран спорта 
необходимо запускать эту команду в розі: - гесеіѵе хуке: 



=> 6ЕТ іп-Го/гег"з 




са82а6СІгТ817ес66г'443420072Ѳ2690а93763949 


ге-Гз/Иеааз/тазЬег 



Теперь у нас имеется список удалённых веток и их хеши. Далее, нам надо посмотреть 
куда ссылается НЕАБ, чтобы знать на какую версию переключиться после завершения работы 
команды. 

=> 6ЕТ НЕАР 

ге-Г: ге-рз/Неасіз/тазіег 



Нам надо переключиться на ветку тазііег после завершения процесса. На данном этапе 
можно начать обход дерева. Начальной точкой является объект-коммит са82а6, о чём мы 
узнали из файла іітГо/ге^з, и мы начинаем с его загрузки: 

=> 6ЕТ оЬзес1:з/са/82а6сЛ = -Г817ес66Г44342Ѳ072Ѳ2690а93763949 
(179 Ьуіез от" Ьіпагу сіа1:а) 



Объект получен, он был в рыхлом формате на сервере, и мы получили его по НТТР используя 
статический СЕТ-запрос. Теперь можно его разархивировать, отрезать заголовок и посмотреть 
на его содержимое: 

$ діИ саИ-Ше -р са82а6<згТ817ес66г'44342007202690а93763949 

г. гее сГсІаЗЬГ379е41 = 8сІЬа8717сіее55ааЬ78ае1 = 71 = 4сІа1 = 

рагепі 085ЬЬЗЬсЬ608е1е8451а'4Ь2432г'8есЬе6306е7е7 

аіЯНог ЗсоГ.1: СИасоп <зсИасоп§дтаі1 . сот> 1205815931 -0700 

соттіііег 5СОИ1: СМасоп <зсИасоп§дтаі1 . сот> 1240030591 -0700 

сИапдесІ ЬЬе ѵегзіоп питЬег 



Далее, необходимо загрузить ещё два объекта: сГсІаЗЬ — объект-дерево, который обозначен 
как содержимое только что загруженного коммита, и085ЬЬЗ — родительский коммит: 
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=> 6ЕТ оЬзесИз/Ѳ8/5ЬЬЗЬсЬ608е1е8451с14Ь2432г"8есЬе63Ѳ6е7е7 
(179 Ьуіез оТ сІаИа) 



Так, мы получили следующий объект-коммит. Прихватим и наш объект-дерево: 



=> 6ЕТ 0ЬзесИз/сг7сІаЗЬ-Г379е4г'8сІЬа8717гіее55ааЬ78ае-Г7-Г4сІаг' 
(4Ѳ4 - N01: Роипо 1 ) 




ОЙ! Похоже, этого объекта-дерева нет на сервере в рыхлом формате, поэтому мы получили 
ответ 404. У этого могут быть разные причины: объект в другом репозитории, или в упакованном 
файле текущего репозитория. Сперва С-іі проверяет список альтернативных репозиториев: 

=> (ЗЕТ оЬзесІз/іітГо/ІіИр-аИегпаіез 
{етріу -рііе) 



Если бы этот запрос вернул нам список альтернативных ІШЬ, С-іГ обратился по ним в 
поиске «рыхлых» и раск-файлов — это такой механизм, позволяющий не дублировать данные 
проектам, являющимися форками друг для друга. Так как в данном случае альтернативных 
адресов нет, объект должен быть в раск-файле. Для того, чтобы узнать, какие упакованные 
файлы есть на сервере, необходимо загрузить файл со списком раск-файлов: оЪ] есг.5/ ігтГо/ 
раскз (который также генерируется ирсІаг.е-зегѵег-ігтРо): 

=> СЕТ оЬзесіз/ігтГо/раскз 

Р раек -816а9Ь2334с]а9953е530г"27Ьсас22082а9г"5Ь835. раек 

На сервере имеется только один раск-файл, поэтому объект точно там, но необходимо 
проверить индексный файл, чтобы в этом убедиться. Если бы на сервере было несколько 
раск-файлов, загрузив сначала индексы, мы смогли бы определить в каком именно раск-файле 
находится нужный нам объект: 

=> ОЕТ 0ЬзесИ5/раск/раск-816а9Ь2334а'а9953е53Ѳг'27Ьсас22Ѳ82а9г'5Ь835.іа'х 
(4к оТ Ьіпагу оіаіа) 



Теперь, когда мы получили индекс упакованного файла, можно проверить, тут ли наш 
объект. Это возможно благодаря тому, что в индексе хранятся 5НА-1 объектов содержащихся 
в раск-файле, а также их смещения. Необходимый объект там присутствует, так что продолжим 
и получим весь раск-файл: 
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=> СЕТ 0ЬзесИз/раск/раск-816а9Ь2334с1а9953е53Ѳг'27Ьсас22Ѳ82а9г'5Ь835. раек 
(13к оТ Ьіпагу сіат:а) 



Итак, мы получили наш объект-дерево, можно продолжить обход списка коммитов. Все 
они лежат внутри упакованного файла, который мы только что скачали, так что снова обращаться 
к серверу не надо. С-іг извлекает рабочую копию ветки тазііег, на которую ссылается НЕАБ. 

Полный вывод этого процесса выглядит так: 

$ діі сіопе Н1:1:р://дііНиЬ.сот/зсПасоп/зітр1едіі-ргоді1:.ді1: 

Іпіііаіігесі етріу біі герозі1:огу іп /ргіѵа1:е/ітр/зітр1еді1:-ргоді1:/.ді1:/ 

дои са82аба , гТ8і7есббг'44342007202б90а937б3949 

ыаік са82а6а , гТ817ес66т'44342007202690а93763949 
дои 085ЬЬЗЬсЬ608е1е8451а , 4Ь2432г'8есЬе6306е7е7 

беіііпд аНегпаЬез ІізГ. -Тог Ыір : //ді1:ИиЬ . сот/зсИасоп/зітр1еді1:-ргоді1: . діГ. 
СеШпд раек Іізі ■Тог Н1:1:р://ді1:НиЬ.сот/5сНасоп/5ітр1еді1:-ргоді1:.діг. 
беіііпд іпсіех Тог раек 816а9Ь2334а , а9953е530г'27Ьсас22082а9г'5Ь835 
беЬЬіпд раек 816а9Ь2334а , а9953е530г'27Ьсас22082а9г'5Ь835 
иНісіі сопИаіпз сг'сІаЗЬт'379е4г'8сІЬа8717а , ее55ааЬ78ает'7т'4а'аг' 
маік 085ЬЬЗЬсЬ608е1е8451аЧЬ2432г'8есЬе6306е7е7 
\л/а1к а11Ье1 = 06аЗг'659402т'е7563аЬг'99асІ00а , е2209е6 



9.6.2 Умный протокол 

Методика работы НТТР проста, но неэффективна, поэтому чаще используются «умные» 
протоколы. Эти протоколы обслуживаются процессом на стороне сервера, который учитывает 
особенности работы С-іГ — он считывает локальные данные, выясняет что есть и чего не хватает 
на клиенте и генерирует для него соответствующие данные. Существует два набора процессов 
передачи данных: процессы для загрузки данных и процессы для скачивания. 

Загрузка данных Для загрузки данных на удалённый сервер используются процессы 5 е П СІ - 
раек и гесеіѵе- раек. Процесс зепсі-раск запускается на стороне клиента и подключается 
к гесеіѵе-раск на стороне сервера. 

Например, выполняется команда діі: ризгі огідіп тазііег и огідіп определён как 
ІШЬ использующий протокол 55Н. С-іг запускает процесс зепсі - раек, который устанавливает 
соединение с сервером по протоколу 55Н. Он пытается запустить команду на удалённом сервере 
через вызов команды ззЬ, который выглядит следующим образом: 

$ ззИ -х діІіідііИиЬ . сот "діг.- гесеіѵе-раск 1 зсИасоп/зітрІедіі-ргодіІ: . діі 1 " 
005Ьса82а6а , тТ817ес66г'4437202690а93763949 гет'з/Неаа'з/тазГ.ег герогИ-зИаНиз сіеіеіе- гетз 
003е085ЬЬЗЬсЬ608е1е84Ь2432т'8есЬе6306е7е7 геГз/Ііеасіз/Г.оріс 
0000 




Команда діі. - гесеіѵе - раек тут же посылает в ответ по одной строке на каждую из 
имеющихся в наличии ссылок — в данном случае только ветку тазііег и её 5НА. Первая 
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строка также содержит список возможностей сервера (здесь это героП-зЪаЪизи сіеіеііе- 
ге-Гз). 

Каждая строка начинается с 4-байтового шестнадцатеричного значения, содержащего длину 
оставшейся строки. Первая строка начинается с 005Ъ, это 91 в 16-ричном виде, значит в этой 
строке ещё 91 байт. Следующая строка начинается с ООЗе, что означает 62, то есть надо 
прочитать 62 байта. Далее следует строка 0000, которая означает, что сервер закончил листинг 
своих ссылок. 

Теперь, когда процесс зепсі - раек выяснил состояние сервера, он определяет коммиты, 
которые есть локально, но которых нет на сервере. Для каждой ссылки, которая будет обновлена 
текущей командой риз И, процесс зепсі - раек передаёт процессу гесеіѵе- раек эти данные. 
Например, если мы обновляем ветку тазііег, и добавляем ветку ехрегітепі:, ответ зепсі - 
раек будет выглядеть следующим образом: 

ѲѲ85са82а6СІ1 ; Г817ес66Г44342ѲѲ72Ѳ2690а93763949 15027957951Ь64ст'874с3557а0т'3547ЬсІ83ЬЗгТ6 геТв/ 
Неасіз/тазііег герогі-зііаііиз 

ѲѲ67Ѳ000ѲѲѲѲѲѲѲѲѲѲ0000ѲѲѲѲѲѲѲѲѲѲ000ѲѲѲ0000ѲѲ ССІг"сІЬ42577е2506715г'8ст'еасс1ЬаЬс092Ьт'63е8сі гетз/ 

Неасіз/ехрегітепі: 

00ѲѲ 




Значение 5НА-1 из одних нулей означает, что раньше здесь ничего не было — так получилось 
из-за того, что мы добавили новую ссылку ехрегітепі:. Если бы мы удаляли ссылку, было 
бы на оборот: одни нули были бы справа. 

Сіі отправляет строку для каждой ссылки, для которой производится обновление. В строке 
содержится старый хеш, новый хеш и имя обновляемой ссылки. Первая строка также содержит 
возможности клиента. Далее, клиент загружает упакованный файл со всеми объектами, которых 
ещё нет на сервере. В конце, сервер отвечает статусным сообщением сообщающем об успехе 
(или ошибке): 

000Аипраск ок 



Скачивание данных Если выполняется скачивание данных, используются процессы 1"е1:сп - 
раек и иріоасі - раек. Клиент запускает процесс геіісгі - раек, который подключающийся 
к процессу и ріоасі - рас к на удалённой машине для определения, какие данные будут переданы. 

Существуют разные способы запуска иріоасі - раек на удалённом репозитории. Можно 
запустить его по 55Н так же, как и гесеіѵе - раек. Ещё можно вызвать процесс через СП- 
демон, по умолчанию принимающий соединения на порте 9418. Процесс 'Реіісгі - раек после 
подключения отправляет демону данные примерно следующего вида: 



0ѲЗг"ді(:-ир1оасі-раск зсНасоп/зітр1еді1:-ргоді1: . діі\0Иоз1:=тузегѵег . сот\0 




Начальные 4 байта задают размер последующих данных, далее следует команда, которую 
следует запустить, завершаемая нулевым байтом, а потом имя сервера и последний нулевой 
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байт. Ск-демон проверяет возможность выполнения команды, а также, что репозиторий существует 
и имеет необходимые права доступа. Если всё хорошо, демон запускает процесс иріоасі- 
раск и передаёт запрос ему. 

Если извлечение данных производится по 55Н, 'ГеІісИ - раек выполняет другие действия: 

$ ззН -х ді!:§ді1:НиЬ . сот "діі-иріоасі-раск ' зсНасоп/зітрІедіі-ргодіІ: . діі 1 " 



В обоих случаях, после того как 1 = е1:сгі - раек подключится, иріоасі-раск передаст 
обратно следующее: 

0088са82абсМ ; т"817есббг'44342007202б90а937б3949 НЕАО\0ггш1І:і_аск СИіп-раск \ 

зісіе-Ьапсі зіо'е-Ьапсі-64к о-рз-сіеііа зНаІІои по-ргодгезз іпс1исіе-1:ад 
003гса82а6сітТ8:і.7ес66г'44342007202690а93763949 геГз/ИеасІз/тазіег 
003е085ЬЬЗЬсЬ608е1е8451сі4Ь2432г"8есЬе6306е7е7 геГз/НеасІз/іоріс 
0000 



Это очень похоже на ответ гесеіѵе- раек, но только возможности другие. В добавок 
иріоасі - рас к отсылает обратно ссылку НЕАБ, чтобы клиент понимал, на какую ветку переключиться, 
если выполняется клонирование. 

На данном этапе процесс 1 = е1:сИ-раск смотрит на объекты, имеющиеся в наличии и для 
недостающих объектов отвечает словом «шапі» и за ним 5НА объекта. Для уже имеющихся 
объектов процесс отправляет их хеши со словом «Ьаѵе». В конце списка он пишет «сіопе», и 
это даёт понять процессу иріоасі - раек, что пора начинать отправлять упакованный файл с 
необходимыми данными: 

0054иапі са82а6сІгТ817ес66г44342007202690а93763949 отз-сІеИа 

0032Маѵе 085ЬЬЗЬсЬ608е1е8451аЧЬ2432т'8есЬе6306е7е7 

0000 

0009сіопе 




Это самый основной случай передачи данных. В более сложных случаях, клиент поддерживает 
функции ши11:і_аск или зісіе - ЬапсІ, но этот пример иллюстрирует основные взаимодействия 
используемые процессами умного протокола. 

9.7 Обслуживание и восстановление данных 

Иногда, требуется выполнить очистку — сделать репозиторий более компактным, почистить 
импортированный репозиторий, или восстановить потерянную работу. Данный раздел охватывает 
некоторые из этих сценариев. 

9.7.1 Обслуживание 

Иногда СіІ сам выполняет команду запускающую автоматический сборщик мусора. Чаще 
всего, эта команда ничего не делает. Однако, если неупакованных объектов слишком много, 



265 



Глава 9 Оіі изнутри 



Зсоіі СЬасоп Рго Сіі 



или у вас слишком много раск-файлов, Сіг запускает полноценную команду діі дс. Здесь 
дс это сокращение от «§агЬа§е соііесі», что означает «сборка мусора». Эта команда выполняет 
несколько действий: собирает все объекты в рыхлом формате и упаковывает их в раск-файлы, 
объединяет несколько упакованных файлов в один большой, удаляет объекты недостижимые 
ни из одного коммита и те, которые хранятся дольше нескольких месяцев. 
Вы также можете запустить сборку мусора вручную: 



$ діі дс --аиіо 




Опять же, как правило, эта команда ничего не делает. Необходимо иметь 7000 несжатых 
объектов или более 50 упакованных файлов, чтобы запустился настоящий дс. Данные пределы 
можно изменить с помощью параметров дс.аиііоидс. аи 1: о рас кіішіі: в конфигурационном 
файле. 

Другое действие, выполняемое дс — упаковка ссылок в единый файл. Предположим, 
репозиторий содержит следующие ветки и теги: 

$ -ГіпсІ .діІі/ге-Гз -1:уре Т 
. діі/ге-рз/Неасіз/ехрегітепІ: 
. діі/ге^з/НеасІз/тазіег 
. діі/ге-рз/ііадз/ѵі . 0 
. діі/ге-рз/ііадз/ѵі . 1 



Если выполнить діі: дс, данные файлы в каталоге ге'Гз перестанут существовать. Сіі 
перенесёт их в файл .дііі/раскесі-ге^зв угоду эффективности. Файл будет иметь следующий 
вид: 



$ саі: . ді1:/раскесі- ге-Гз 




# раск-гет'з рееіей 




сас0саЬ538Ь970а37еа1е769сЬЬсІе608743Ьс96сі 


ге-Гз/Иеасіз/ехрегітепІ: 


аЫаГеГ8Ѳ-Гас8е34258ГГ41-Гс1Ь867с702сІаа24Ь 


ге-Гз/Иеасіз/піазіег 


сас0саЬ538Ь970а37еа1е769сЬЬсіе608743Ьс96сі 


ге^Гз/іадз/ѵІ . 0 


9585191г'37т'7ЬѲг"Ь9444г'35а9Ьт"50СІе191Ьеас1с2 


ге-Гз/іадз/ѵІ . 1 


ліа410егЪгі13591сІЬ07496601еЬс7а059сІсІ55сте9 



При обновлении ссылки, СіІ не будет редактировать этот файл, а добавит новый файл в 
гег'з/Неайз. Для получения хеша для нужной ссылки, Сіг сначала проверит наличие ссылки 
в каталоге гег'з, а к файлу раскесі - гег'з обратится только в случае неудачи. Однако, если в 
каталоге гег'з файла нет, скорее всего, он в раскесі - гег'з. 

Заметьте, последняя строка файла начинается с * . Это означает, что метка непосредственно 
над ней является аннотированной и данная строка это коммит, на который аннотированная 
метка указывает. 

9.7.2 Восстановление данных 

В какой-то момент при работе с Сіі, вы нечаянно можете потерять коммит. Как правило, 
такое случается, когда вы удаляете ветку, в которой находились некоторые наработки, а потом 
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оказывается, что они всё-таки были нужными. Либо вы жёстко сбросили ветку, тем самым 
отказавшись от коммитов, которые теперь понадобились. Как же в таком случае заполучить 
свои коммиты обратно? 

Рассмотрим пример, в котором жёстко сбросим ветку тавіег в тестовом репозитории на 
какой-нибудь более ранний коммит и затем восстановим потерянные коммиты. Для начала, 
рассмотрим в каком состоянии находится репозиторий на данном этапе: 



$ діі Іод - -ргеііу^опеііпе 




аЬ1аг'ег'8Ѳт'ас8е34258г'г'4Ггс:і.Ь867с702сІаа24Ь 


тосіі-ріесі геро а Ьіі 


484а59275Ѳ319Ѳ9е19аасІЬ7с92262719с1 = СС|-Г19а 


асісіесі геро.гЬ 


1а410еГЬсі13591сІЬѲ7496601еЬс7аѲ59сІсІ55с1 = е9 


ІИігсІ соттіі: 


сас0саЬ538Ь970а37еа1е769сЬЬа'е608743Ьс96а' 


зесопсі соттіі: 


1 = СІГ4Гс3344е67аЬѲ681 ; 836878Ь6с4951еЗЫ5-ГЗсі 


г"ігз(: соттіі: 



Теперь сдвинем ветку тазііег на несколько коммитов назад: 



$ діИ гезеИ --ИагсІ 1а410етЪа , 13591сІЬ07496601еЬс7а059сіа , 55сг'е9 


НЕАО із пом аі: 1а410ет' 1:пігсІ соттіі 




$ діі Іод - -рге11у=опе1л_пе 




1а41Ѳе1 ; ЬсЛ3591сіЬѲ7496601еЬс7аѲ59сІсІ55с-Ге9 


ІИігсІ соттИ 


сас0саЬ538Ь970а37еа1е769сЬЬсІе608743Ьс96а' 


зесопсі соттіі 


1 = СІГ4Гс3344е67аЬѲ681 ; 836878Ь6с4951еЗЫ5-ГЗсі 


г"ігз(: соттіі 



Итак, теперь два последних коммита по-настоящему потеряны — они не достижимы ни 
из одной ветки. Необходимо найти 5НА последнего коммита и создать ветку, указывающую 
на него. Сложность в том, чтобы найти этот самый 5НА последнего коммита, ведь вряд ли вы 
его запомнили, да? 

Зачастую, самый быстрый способ — использовать инструмент под названием діі: г е - 
1"1од . Во время вашей работы, СіГ записывает все изменения НЕАБ. Каждый раз при переключении 
веток и коммите, добавляется запись в гейо§. Также обновление производится при вызове 
діі ирсіаіе - геТ, это, в частности, является причиной необходимости использования этой 
команды вместо прямой записи значения хеша в геі-файл, как было рассмотрено в разделе 
«Ссылки в СіГ» в этой главе. Итак, изменения НЕАБ в хронологическом порядке можно увидеть, 
вызвав діі: ге"Г1од: 



$ д±1 ге'Под 






ІаЛІѲеТ НЕАО§{0}: 


1а410ет'ЬсІ13591сІЬ07496601еЬс7а059сісі55сг"е9: 


ирсіаііпд НЕАО 


аЫаТеТ НЕА0§{1} : 


аЬ1ат'ет'80г'ас8е34258тТ41г'с1Ь867с702а , аа24Ь: 


ирсіаііпд НЕАО 



Здесь мы видим два коммита, на которых мы когда-то находились, однако информации 
не так много. Более интересный вывод можно получить, используя діі Іод -д, что даст 
стандартный вывод лога для записей из геі1о§: 
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$ діі Іод -д 

соттіі 1а410егЪа , 13591а , ЬѲ74966Ѳ1еЬс7аѲ59а , а , 55сг"е9 

Кег"1од : НЕА0§{Ѳ} (5соі1: СИасоп <зсІіасоп§дтаі1 . сот>) 

Кег"1од теззаде: ирйаііпд НЕАй 

АиІіИог: Зсоіі СМасоп <зсИасоп§дтаі1.сот> 

Оаіе: Ргі Мау 22 18:22:37 2ѲѲ9 -07ѲѲ 

ІМігсІ соттіі: 

соттіі аЫаг"ег"8Ѳг"ас8е34258гТ41г'с1Ь867с702а , аа24Ь 

Кег"1од : НЕА0§{1} (Зсоіі: СИасоп <зсПасоп§дтаі1 . сот>) 

Кег"1од теззаде: ирсіаііпд НЕАй 

АиІіМог: ЗсоЫ: СИасоп <зсИасоп§дтаі1.сот> 

Оаіе: Ргі Мау 22 18:15:24 2ѲѲ9 -07ѲѲ 

тосІгРіесІ геро а Ьіг. 



Похоже, что нижний коммит это тот, который мы потеряли, и он может быть восстановлен 
созданием ветки, указывающей на него. Например, создадим ветку с именем гесоѵег - ЬгапсН, 
указывающую на этот коммит (аМаМ): 



$ діі ЬгапсИ гесоѵег-ЬгапсИ аЫат'ет' 






$ діі Іод - -рге11:у=опе1іпе гесоѵег-ЬгапсИ 




аЫаг'ег'8Ѳт'ас8е34258гТ4Ггс1Ь867с702сІаа24Ь 


тосіі^іесі геро а Ьіі 


484а59275Ѳ31909е19аасІЬ7с92262719сг'саТ19а 


асісіесі 


геро . гЬ 


1а41Ѳег'Ьа , 13591а , ЬѲ7496601еЬс7аѲ59сІсІ55ст'е9 


ІИігсІ 


соттіі: 


сас0саЬ538Ь97Ѳа37еа1е769сЬЬа , е6Ѳ8743Ьс96а' 


зесопо 


1 соттіі: 


г"сІг'4г'с3344е67аЬѲ68г'836878Ь6с4951еЗЫ5т'ЗсІ 


гігзі 


соттіі: 



Здорово, теперь у нас есть ветка гесоѵег - ЬгапсН, указывающая туда, куда ранее указывала 
шазііег, и потерянные коммиты вновь доступны. Теперь, положим, потерянная ветка по 
какой-то причине не попала в гейо§, для этого удалим восстановленную ветку и весь гейо§. 
Теперь два первых коммита недоступны ниоткуда: 



$ діі ЬгапсИ -0 гесоѵег-ЬгапсИ 
$ гт -К-р . діі/іодз/ 




Теперь данные из . дііі/іодз/ удалены, а значит и гейо§ больше нет, так как все его 
данные находились там. Как восстановить коммиты теперь? Один способ — использовать 
утилиту діі гзск, проверяющую базу на целостность. Если выполнить её с ключом - - 
■риіі, будут показаны все объекты недостижимые из других объектов: 

$ діі -Гзск ---Гиіі 

сіапдііпд ЫоЬ а'67Ѳ460Ь4Ь4аесе5915сат'5с68а , 12г"56Оа9т'еЗе4 
сіапдііпд соттіі: аЫаг'ет'8Ѳт"ас8е34258тТ41т"с1Ь867с7Ѳ2а , аа24Ь 
сіапдііпд Игее аеа790Ь9а58т"6сг"6г"28Ѳ4ееас9^ѲаЬЬе9631е4с9 
сіапдііпд ЫоЬ 71Ѳ8г7есЬ345ее9а'ѲѲ84193г'147са , аа , 4сІ2998293 
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В данном случае потерянный коммит указан после слов «сіап§1іп§ соттк» (сіап§Ип§ сот- 
ті( в пер. с англ. — «висячий» коммит). Его можно восстановить аналогичным образом, 
добавив ветку, указывающую на данный хеш. 

9.7.3 Удаление объектов 

У СіГ есть много замечательных особенностей, но одна из них способна вызвать проблемы — 
команда діі сіопе загружает проект вместе со всей историей включая все версии всех 
файлов. Это нормально, если в репозитории хранится только исходный код, так как СіІ хорошо 
оптимизирован под такой тип данных и может эффективно сжимать их. Однако, если когда- 
либо в проект был добавлен большой файл, каждый кто потом захочет клонировать проект 
будет вынужден скачивать этот большой файл, даже если он был удалён в следующем же 
коммите. Он будет в базе всегда просто потому, что он доступен в истории. 

Это может стать огромной проблемой при конвертации репозиториев ЗиЬѵегзіоп или Рег- 
гогсе в СіС В данных системах вам не нужно загружать всю историю, поэтому добавление 
больших бинарных файлов не имеет там особых последствий. Если при импорте из другой 
системы или при каких-либо других обстоятельствах стало ясно, что ваш репозиторий намного 
больше, чем он должен быть, то как раз сейчас мы расскажем как можно найти и удалить 
большие объекты. 

Будьте внимательны, данный способ разрушителен по отношению к истории коммитов. 
Каждый коммит будет переписан начиная с самого раннего, из которого вы удалите ссылку 
на большой файл. Если сделать это непосредственно после импорта, когда никто ещё не 
работал с репозиторием, всё хорошо, иначе придётся сообщать всем участникам разработки 
о необходимости перемещения их правок на новые коммиты. 

Для примера, добавим большой файл в свой тестовый репозиторий, удалим его в следующем 
коммите, а потом найдём и удалим его полностью из базы. Для начала добавим большой файл 
в нашу историю: 

$ сигі Ыір : //кегпеі. огд/риЬ/зот"(:маге/зст/ді1:/ді1:-1. 6 . 3 . 1 . іаг . Ьг2 > діІ.і.Ьт.2 

$ діі асісі діИ.ИЬгг 

$ діі соттіі: -ат 1 асісіесі діі СагЬаІІ' 

[тазНег 6гіт7640] асісіесі діИ ИагЬаІІ 

1 -Гііез сНапдесІ, 0 іпзег1:іопз( + ) , Ѳ с!е1е1:іопз( - ) 

сгеаСе тосіе 100644 діИ.1:Ь22 



Упс, кажется, этот огромный архив нам в проекте не нужен. Избавимся от него: 

$ діі гт ді!:.1:Ь22 
гт 'діЬ.^Ьгг' 

$ діі соттіі: -т 'оорз - гетоѵесі Іагде іагЬаІІ 1 
[тазЬег баЗТЗѲб] оорз - гетоѵесі Іагде ІагЬаІІ 

1 -Гііез сИапдесі, 0 іпзег1:іопз( + ) , 0 с!е1е1:іопз( - ) 

сіеіеіе тосіе 100644 діИ.1:Ь22 



Теперь «соберём мусор» в базе и узнаем её размер: 
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$ діі дс 

СоипЫпд о^ес^в: 21, сіопе. 
Эеііа сотргеззіоп изіпд 2 1:Игеасіз. 
Сотргеззіпд оЬзесЬз: 1ѲѲ% (16/16), Йопе. 
Іл/гіііпд оЬзесИз: 100% (21/21), сіопе. 
Тоіаі 21 (сіеІИа 3), геизесі 15 (сІеІСа 1) 

Чтобы быстро узнать сколько у нас занято места, можно воспользоваться командой со и п 1: - 
оЬзесІіз: 

$ діі соип1:-оЬ}ес1:з -ѵ 
соипі:: 4 
зі2е: 16 
іп-раск: 21 
раскз: 1 
зі2е-раск: 2016 
ргипе-раскаЫе : Ѳ 
дагЬаде: 0 




Запись 5І2е - раек — это размер упакованных файлов в килобайтах, то есть всего занято 
2 МБ. Перед последним коммитом, использовалось около 2 КБ, то есть, удаление файла не 
удалило его из истории. Из-за того, что мы однажды случайно добавили большой файл, при 
каждом клонировании этого репозитория каждому человеку придётся скачивать все эти 2 МБ, 
только для того, чтобы получить этот крошечный проект. Попробуем избавиться от этого 
файла. 

Сперва найдём его. В данном случае, мы знаем, что это за файл. Но если бы не знали, 
как можно было бы определить, какие файлы занимают много места? При вызове діі: дс 
все объекты упаковываются в один файл, несмотря на это определить самые крупные файлы 
можно запустив служебную команду діі ѵегігу- раек, и отсортировав её вывод по третьей 
колонке, в которой записан размер файла. К тому же, так как нас интересуют только самые 
крупные файлы, оставим только последние несколько строк, направив вывод команде іаіі: 



$ діі ѵегі1"у-раск -ѵ .діІі/оЬзесіз/раск/раск-З^ЗсѲ. . .ЬЬ.ісІх | зогі: -к 3 -п 


| Иаіі -3 


езгоэдГбггбгэаеЗБввѳбЫУсіаГУзгдбсгусѳѳуь 


ЫоЬ 


1486 734 4667 




О5408сІ195263с1853г"Ѳ9сІса71СІ55116663690с27с 


ЫоЬ 


12908 3478 1189 




7а9еЬ2ГЬа2Ы811321254ас360970Гс169Ьа2330 


ЫоЬ 


2056716 2056872 5401 





Большой объект в самом внизу, его размер — 2 МБ. Для того, чтобы узнать, что это за 
файл, воспользуемся командой геѵ-іізі:, которая уже упоминалась в главе 7. Если передать 
ей ключ - -оЬзес1:5,то она выдаст хеши всех коммитов, а также хеши объектов и соответствующие 
им имена файлов. Воспользуемся этим для определения имени выбранного объекта: 

$ діі геѵ-1із1: --оЬзес1:з --аіі | дгер 7а9еЬ2т"Ь 
7а9еЬ2г'Ьа2Ы811321254ас360970г"с169Ьа2330 дІИ . СЬ22 
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Теперь необходимо удалить данный файл из всех деревьев в прошлом по истории. Легко 
получить все коммиты, которые меняли данный файл: 



$ діі Іод - -рге11:у=опе1іпе -- діг..г.Ь22 






СІа31 = 30СІ019ѲѲ5479с99еЬ4с3406225613985а1а , Ь 


оорз 


- гетоѵесі Іагде г.агЬа11 


6аТ764092гЗе7с8г'51 = 94сЬе08ее5сг'42е92а0289 


асісіесі 


діт: г.агЬа11 



Необходимо переписать все коммиты, начиная с 6СІГ76 для полного удаления данного 
файла. Для этого воспользуемся командой г'л.Игег - ЬгапсН, которая приводилась в главе 6: 



$ діі гі1г.ег-Ьгапсгі - -іпсІех-гіИег \ 




'діг. гш --сасгіесі - -ідпоге-иптаісИ діг..г.Ь22' -- 


6СІГ764ѲЛ. . 


Веигііе 6сіт764Ѳ92тЗе7с8г5г94сЬе08ее5ст42е92аѲ289 


(1/2) гт 'діі.ИЬгг' 


Реигіг.е сіаЗтЗѲа , Ѳ19005479с99еЬ4с3406225613985а1сІЬ 


(2/2) 


Ке-Г ' гегз/гіеасіз/тазг.ег ' иаз геигіг.г.еп 





Опция - -Іпсіех-^ііііег похожа на - -Ъгее-'РНЪег использовавшуюся в главе 6, за 
исключением того, что вместо передачи команды, модифицирующей файлы на диске, мы используем 
команду, изменяющую файлы в индексе. Вместо удаления файла чем-то вроде гт гііе, стоит 
сделать это командой діі: гт - - сасИесІ, так как нам надо удалить файл из индекса, а не с 
диска. Причина, по которой мы делаем именно так — скорость. Нет необходимости извлекать 
каждую ревизию на диск, чтобы применить фильтр, а это может очень сильно ускорить процесс. 
Можете использовать и ^гее-'ГШег для получения аналогичного результата, если хотите. 
Опция - -ідпоге-ипша1:сИ команды діі гш отключает вывод сообщения об ошибке в 
случае отсутствия файлов, соответствующих шаблону. И последнее, команда гі11:ег - ЬгапсН 
переписывает историю начиная с коммита 6сІ1 = 7640, потому что мы знаем, что именно с 
этого коммита появилась проблема. По умолчанию перезапись начинается с самого первого 
коммита, что потребовало бы гораздо больше времени. 

Теперь наша история не содержит ссылок на данный файл. Однако, в гейо§ и в новом 
наборе ссылок, добавленном Сіг'ом в .дііі/ге^з/огідіпаі после выполнения 1 = і11:ег- 
ЬгапсН, ссылки на него всё ещё присутствуют. Поэтому необходимо их удалить, а потом 
переупаковать базу. Необходимо избавиться от всех возможных ссылок на старые коммиты 
перед переупаковкой: 

$ гт -Кг . діг./ге^з/огідіпаі 
$ гт -К-р .дігѴІодз/ 
$ діИ дс 

СоипИпд оЬзесг.5: 19, сіопе. 
Оеііа сотргеззіоп изіпд 2 г.гігеасІз. 
Сотргеззіпд оЬзесЬз: 1ѲѲ% (14/14), сіопе. 
Ыгіііпд оЬзесИз: 100% (19/19), сіопе. 
Тоіаі 19 (сіеІИа 3), геизесі 16 (сІеІСа 1) 



Посмотрим, сколько места удалось сохранить: 
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$ діі соип1:-оЬ}ес1:5 -ѵ 
соипі:: 8 
зі2е: 204Ѳ 
іп-раск: 19 
раскз: 1 
зіге-раск: 7 
ргипе-раскаЫе : Ѳ 
дагЬаде: Ѳ 



Размер упакованного репозитория сократился до 7 КБ, что намного лучше, чем 2 МБ. Из 
значения поля 5І2е видно, что большой объект всё ещё хранится в одном из ваших «рыхлых» 
объектов, но, что самое важное, при любой последующей отправке данных наружу и в том 
числе при клонировании он передаваться не будет. Если очень хочется, можно удалить его 
навсегда локально, выполнив діі: ргипе --ехріге. 

9.8 Итоги 

Теперь вы довольно хорошо понимаете, что Сіг делает в фоне и, в некоторой степени, как 
он написан. В данной главе мы рассмотрели несколько служебных команд — простых команд 
работающих на более низком уровень, чем обычные пользовательские команды описанные в 
остальной части книги. Понимание принципов работы СіІ на низком уровне упрощает понимание 
работы СіІ в целом и даёт возможность написания собственных утилит и сценариев для организации 
специфического процесса работы с СіГ. 

Сіі как контентно-адресуемая файловая система, это очень мощный инструмент, который 
можно использовать не только как систему управления версиями. Надеюсь, полученное знание 
внутренней реализации СіГ поможет вам в написании ваших собственных интересных приложений 
использующих данные технологии и сделает вашу работу с СіГ более продвинутой и комфортной. 
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